> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Mises à niveau

> Mises à jour logicielles, mises à niveau du consensus et maintenance

## Pourquoi les mises à niveau sont importantes

L'architecture de Plasma évolue rapidement pour prendre en charge des cas d'usage à haut débit, natifs des stablecoins. Les mises à niveau ponctuelles :

* Protègent contre les vulnérabilités de sécurité
* Améliorent les performances des charges de travail de paiement
* Maintiennent la compatibilité avec la couche de consensus et l'interface RPC de Plasma

Les nœuds obsolètes peuvent rencontrer des échecs de synchronisation, des performances dégradées ou des problèmes de sécurité. Comme les nœuds non validateurs servent souvent un trafic RPC critique pour les applications de paiement, il est essentiel de rester à jour.

<Note>
  La plupart des mises à niveau de nœuds non validateurs nécessitent 15 à 30 minutes de temps d'arrêt. Les versions majeures introduisant de nouvelles fonctionnalités ou des changements de consensus peuvent nécessiter des fenêtres de synchronisation plus longues.
</Note>

## Types de mises à niveau

<Columns cols={3}>
  <Card title="Correctifs de sécurité" href="#security-patches">
    Corrections critiques pour la protection de l'infrastructure de paiement
  </Card>

  <Card title="Mises à jour de fonctionnalités" href="#feature-updates">
    Nouvelles capacités pour les applications de paiement
  </Card>

  <Card title="Optimisations de performance" href="#performance-optimisations">
    Améliorations pour le traitement de transactions à fort volume
  </Card>
</Columns>

### Correctifs de sécurité

Les correctifs de sécurité corrigent les vulnérabilités dans les clients non validateurs, Reth ou les dépendances.

**Exemples :**

* Vulnérabilités d'incohérence d'état ou de désynchronisation du consensus
* Corrections de contrôle d'accès et d'authentification RPC
* Mises à jour de bibliothèques cryptographiques

Ces correctifs doivent être appliqués immédiatement lors de leur publication.

### Mises à jour de fonctionnalités

Les versions de fonctionnalités activent de nouvelles capacités de protocole ou prennent en charge de nouveaux modèles d'application.

**Exemples :**

* Améliorations des transferts USD₮ sans frais
* Support des tokens de gas personnalisés
* Méthodes RPC nouvelles ou étendues
* Optimisations des requêtes d'état
* Améliorations des intégrations wallet et exchange

### Optimisations de performance

Les versions axées sur la performance améliorent la vitesse d'exécution, l'efficacité de synchronisation et l'utilisation des ressources.

**Exemples :**

* Lectures et écritures plus rapides de la base de données
* Latence RPC réduite sous charge
* Efficacité mémoire et CPU améliorée
* Améliorations de la synchronisation du consensus

## Procédure de mise à niveau

Les mises à niveau des nœuds non validateurs impliquent généralement de récupérer une nouvelle image Docker, de mettre à jour les configurations et de redémarrer le service.

<Steps>
  <Step title="Notifier les applications">
    Informez les services connectés de la maintenance planifiée.
  </Step>

  <Step title="Vérifier la compatibilité">
    Assurez-vous que les nouvelles versions du client non validateur fonctionnent avec les endpoints de consensus actuels.
  </Step>

  <Step title="Mettre à jour la configuration">
    Appliquez toutes les nouvelles options de configuration pour les fonctionnalités améliorées. Portez une attention particulière aux changements affectant le support des tokens de gas personnalisés, le traitement de transactions sans frais ou les interfaces RPC des applications de paiement.
  </Step>

  <Step title="Tester les endpoints RPC">
    Vérifiez la compatibilité avec les applications de paiement après la mise à niveau.
  </Step>

  <Step title="Surveiller le traitement des transactions">
    Assurez-vous du fonctionnement normal pour les transferts USD₮ et les opérations de gas personnalisé.
  </Step>
</Steps>

<Tip>
  Déployez les mises à niveau par étapes lorsque vous exploitez plusieurs nœuds non validateurs. Commencez par des instances non critiques avant de mettre à niveau l'infrastructure de paiement principale, et surveillez attentivement le premier nœud mis à niveau avant de continuer.
</Tip>

## Vérification post-mise à niveau

Après la mise à niveau, vérifiez la synchronisation complète avec la couche de consensus et validez les fonctionnalités principales.

<Check>**Synchronisation du consensus** : La hauteur des blocs s'aligne avec le réseau</Check>
<Check>**Fonctionnalité RPC** : Testez les endpoints clés utilisés par les applications de paiement</Check>
<Check>**Référentiel de performance** : Comparez les métriques post-mise à niveau aux références précédentes</Check>
<Check>**Surveillance** : Validez que les systèmes de surveillance et d'alerte restent opérationnels</Check>

<Tip>
  Documentez les changements de configuration et le comportement observé. Cela améliore la fiabilité des futures mises à niveau et du dépannage. Pour les problèmes courants, consultez le [guide de dépannage](./troubleshooting).
</Tip>

## Procédures de rollback

### Quand faire un rollback

Faites un rollback si vous observez :

* Échec de synchronisation du consensus
* Dégradation sévère de la performance RPC
* Incompatibilité d'application
* Régression de sécurité
* Incohérence de données affectant les soldes ou transferts

### Comment faire un rollback

<Steps>
  <Step title="Arrêter les services">
    Arrêtez les services du nœud non validateur.
  </Step>

  <Step title="Revenir à l'image et la configuration précédentes">
    Revenez à l'image Docker et à la configuration précédentes.
  </Step>

  <Step title="Redémarrer et resynchroniser">
    Redémarrez les services et resynchronisez avec le réseau.
  </Step>

  <Step title="Vérifier la fonctionnalité">
    Re-testez les endpoints RPC et les fonctionnalités de transaction.
  </Step>

  <Step title="Notifier les équipes">
    Notifiez les équipes d'applications du rétablissement.
  </Step>
</Steps>

## Bonnes pratiques

### Automatisation et surveillance

* Automatisez les récupérations d'images et les mises à jour de configuration lorsque c'est possible
* Suivez les changements avec une configuration versionnée
* Améliorez l'observabilité pendant les mises à niveau
* Surveillez de près les taux d'erreurs RPC, le statut de synchronisation et le débit des transactions après les redémarrages

## Dépannage courant

Si des problèmes surviennent après la mise à niveau :

* **Synchronisation du consensus** : Vérifiez la connectivité aux endpoints, les identifiants et le statut de l'allowlist
* **Erreurs RPC** : Validez la configuration, la compatibilité de version et les interfaces mises à jour
* **Régression de performance** : Surveillez l'utilisation des ressources et examinez les notes de version

La mise à niveau des nœuds non validateurs Plasma est essentielle pour maintenir une infrastructure RPC fiable et sécurisée pour les applications basées sur les stablecoins. Suivre des procédures de mise à niveau et de validation structurées minimise les risques et garantit des performances sans interruption.