

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Validation, découpage et restauration lors d'une mise à niveau basée sur un clone

Après avoir lancé une mise à niveau basée sur un clone, OpenSearch Le service crée un cluster cloné de votre domaine et y copie vos données. Lorsque le cluster cloné est prêt, la mise à niveau vous attend. Cette page explique comment valider le cluster cloné, y accéder, annuler la mise à niveau et revenir en arrière. Pour plus d'informations sur les demandes qui exécutent chaque action, voir [Mise à niveau d'un domaine (CLI)](starting-upgrades-cli.md) et [Mettre à niveau un domaine (SDK)](starting-upgrades-sdk.md).

## Surveiller la progression
<a name="clone-monitor"></a>

Pour suivre une mise à niveau basée sur un clone, appelez `DescribeDomainChangeProgress`. La réponse énumère les étapes suivantes. Les étapes font référence au cluster cloné sous le nom de *nouvel environnement* et au cluster principal en tant que *ancien environnement*.


| Étape | Ce que cela signifie | 
| --- | --- | 
| Initialisation | OpenSearch Le service initialise la mise à niveau. | 
| Validation | OpenSearch Le service vérifie que votre domaine est éligible à la mise à niveau. | 
| Création d'un nouvel environnement | OpenSearch Le service crée le cluster cloné. | 
| Approvisionnement de nouveaux nœuds | OpenSearch Le service crée les nœuds du cluster cloné. | 
| Réplication des données | OpenSearch Le service réplique vos données vers le cluster cloné. | 
| Validation de l'application client | Le cluster cloné est prêt. Après la préparation, testez votre application sur la nouvelle version avant de décider de la supprimer ou non. La mise à niveau vous attend. | 
| Changement de trafic | OpenSearch Le service envoie la part du trafic de lecture que vous avez choisie au cluster cloné. | 
| Cut-over vers un nouvel environnement | OpenSearch Le service passe au cluster cloné. | 
| Mise à niveau complète | OpenSearch Le service termine la mise à niveau. | 
| Suppression des anciennes ressources | OpenSearch Le service supprime les ressources associées à l'ancien environnement. | 

Pendant que le cluster cloné vous attend, `ConfigChangeStatus` est `PendingUserInput`. La réponse inclut également `TrafficSplit`, qui indique la part du trafic de lecture qui va au cluster principal et au cluster cloné.

## Validez le cluster cloné
<a name="clone-validate"></a>

Pendant l'attente de la mise à niveau, votre domaine continue de gérer le trafic provenant du cluster principal. Les écritures vont toujours vers le cluster principal, vous ne pouvez donc valider que les lectures. Utilisez l'une des méthodes suivantes.

### Envoyer une part du trafic de lecture au cluster cloné
<a name="clone-validate-traffic"></a>

Utiliser `UpdateClone` avec `TrafficSplitOptions` pour envoyer un pourcentage de demandes de lecture, compris entre 0 et 100, au cluster cloné. Le pourcentage s'applique aux demandes de recherche, telles que `_search`, `_msearch`, `_count`, et `_mget`. Les autres demandes, y compris toutes les écritures, sont envoyées au cluster principal. Vous pouvez modifier le pourcentage aussi souvent que vous le souhaitez. Réglez-le sur 0 pour renvoyer toutes les lectures au cluster principal.

### Utiliser OpenSearch Tableaux de bord sur le cluster cloné
<a name="clone-validate-dashboards"></a>

Si votre domaine fonctionne OpenSearch, ouvrez le cluster cloné OpenSearch Tableaux de bord sur `https://{{my-domain-endpoint}}/_dashboards/clone`. Pour exécuter les mêmes requêtes sur le cluster principal, utilisez l'URL standard des tableaux de bord, `https://{{my-domain-endpoint}}/_dashboards`.

Le `clone` L'URL n'est disponible que jusqu'à ce que vous la coupiez. Après le basculement, le cluster cloné remplace le cluster principal et vous utilisez l'URL standard des tableaux de bord.

### Comparez CloudWatch indicateurs
<a name="clone-validate-metrics"></a>

Le cluster cloné publie des métriques sur le même CloudWatch namespace comme domaine. Le nom de chaque métrique commence par `Clone.`, par exemple `Clone.CPUUtilization`. Surveillez ces mesures dans CloudWatch pour comparer les performances de votre charge de travail sur le cluster principal (la version précédente) et le cluster cloné (la version cible) avant de décider de le supprimer. Pour obtenir une liste complète des métriques, consultez [Clone-based mesures de mise à niveau](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-clone-upgrade).

## Passer au cluster cloné
<a name="clone-cutover"></a>

Lorsque vous êtes satisfait du cluster cloné, passez dessus avec `UpdateClone` et `CutoverOptions` réglé sur `ClonedCluster`. OpenSearch Le service effectue ensuite les opérations suivantes :

1. Vérifie l'état de santé des deux clusters. Si le statut de l'un des clusters est rouge, OpenSearch Le service refuse le transfert.

1. Bloque les écritures dans le cluster principal afin que le cluster cloné puisse rattraper son retard. Les lectures restent disponibles.

1. Attend que le cluster cloné rattrape son retard. Si le cluster cloné ne rattrape pas son retard dans les 5 minutes, OpenSearch Le service débloque les écritures et le basculement échoue.

1. Déplace le trafic vers le cluster cloné. Le point de terminaison de votre domaine ne change pas.

1. Supprime immédiatement le cluster principal ou le conserve pendant la période de rétention que vous avez définie.

**Important**  
Les écritures sont bloquées jusqu'à la fin du découpage. Interrompez pendant une période de faible trafic d'écriture.

## Annuler la mise à niveau avant la mise en service
<a name="clone-cancel"></a>

Vous pouvez annuler à tout moment avant la fin de la période. Appel `UpdateClone` avec `CutoverOptions` réglé sur `PrimaryCluster`. OpenSearch Le service supprime le cluster cloné et votre domaine reste tel quel. Un cluster dont le statut est rouge ne bloque pas une annulation.

## Période de conservation
<a name="clone-retention"></a>

La période de conservation est la durée OpenSearch Le service conserve le cluster principal après le basculement afin que vous puissiez revenir en arrière. Si vous ne définissez pas de période de conservation, OpenSearch Le service supprime le cluster principal immédiatement après le basculement, et le seul moyen de revenir à la version précédente est de restaurer un instantané sur un nouveau domaine.
+ La durée de conservation maximale est de 336 heures (14 jours). Pour demander une période plus longue, contactez [AWS soutien](https://aws.amazon.com/premiumsupport/).
+ Vous pouvez le configurer lorsque vous démarrez la mise à niveau ou lors d'un appel séparé avant la transition. Le délai commence à courir à compter de la fin de la transition.
+ Après la coupure, vous pouvez raccourcir ou prolonger la période avec `RetentionInHours`.
+ Pour terminer la période plus tôt, appelez `UpdateClone` avec `RetentionAction`. Utiliser `RollbackToPrimaryCluster` pour revenir au cluster principal et supprimer le cluster cloné. Utiliser `DeletePrimaryCluster` pour supprimer le cluster principal dès maintenant.

## Revenir en arrière
<a name="clone-rollback"></a>

Pendant la période de rétention, vous pouvez revenir au cluster principal. Appel `UpdateClone` avec `RetentionAction` réglé sur `RollbackToPrimaryCluster`. OpenSearch Le service revient au cluster principal et supprime le cluster cloné.

**Avertissement**  
**Les données écrites après le découpage seront perdues**  
Rollback restaure l'ancien environnement conservé. Les données écrites sur le domaine après le découpage ne seront pas présentes à moins que vous ne les relisiez manuellement.

## Frais
<a name="clone-charges"></a>

Pour plus d'informations sur les frais, voir [Frais liés aux mises à niveau](version-migration.md#upgrade-charges).

## Résolution des problèmes
<a name="clone-troubleshooting"></a>


| Problème | Description | 
| --- | --- | 
| La création d'un cluster cloné échoue | La scène qui a échoué apparaît dans DescribeDomainChangeProgress réponse. Le cluster principal n'est pas affecté. | 
| La copie des données échoue | Si la copie vers le cluster cloné est interrompue ou échoue, Replicating data l'étape échoue. Le cluster principal n'est pas affecté. | 
| Le découpage est rejeté | Le statut de l'un des clusters est rouge. Corrigez les index rouges et réessayez. | 
| Le cutover échoue après le blocage des écritures | Le cluster cloné n'a pas rattrapé son retard en 5 minutes. OpenSearch Le service débloque les écritures automatiquement. Réessayez lorsque le trafic d'écriture est plus faible. | 