Migrer depuis IstioOperator

Le plan de contrôle géré n'est pas directement compatible avec IstioOperator pour la personnalisation. La migration vers le plan de contrôle géré depuis Cloud Service Mesh nécessite une conversion manuelle à partir d'un IstioOperator. Le présent outil permet de réduire les frictions en automatisant le processus.

À propos de l'outil de migration

L'outil de migration évalue de manière non destructive le fichier IstioOperator fourni pour :

  • Rechercher les problèmes de compatibilité.
  • Convertir les configurations IstioOperator compatibles en configurations compatibles avec le plan de contrôle géré, en générant les nouvelles configurations en fichiers.
  • Délivrer des avertissements concernant les valeurs de configuration qui entreraient en conflit avec les valeurs par défaut requises par le plan de contrôle géré.
  • Recommander comment utiliser les fichiers générés.

Cet outil n'examine pas les données ou les configurations de cluster et ne modifie pas la configuration de cluster. Vous devez appliquer séparément tous les fichiers générés.

Avant d'utiliser l'outil de migration, consultez les limites des fonctionnalités compatibles avec le plan de contrôle géré pour vérifier que le plan de contrôle géré est compatible avec votre installation de Cloud Service Mesh.

Utiliser l'outil de migration

L'outil de migration est disponible dans le script asmcli. Vous devez télécharger le script pour utiliser cet outil.

  1. Exécutez l'outil de migration :

    asmcli experimental mcp-migrate-check -f path/to/istiooperator.yaml

  2. Notez les fichiers répertoriés par l'outil, en particulier asm/*meshconfig.yaml et asm/gateways*.

  3. Examinez les avertissements de configuration.

  4. Examinez le résultat et mettez en œuvre les actions requises pour la migration.

Champs MeshConfig non compatibles

Les champs suivants de MeshConfig sont remplacés par le plan de contrôle géré.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata : ces champs spécifiques sont remplacés. Vous pouvez ajouter des champs :
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

Exemple de résultat :

$ asmcli experimental mcp-migrate-check -f some-iop.yaml
asmcli: Downloading ASM..
Generating equivalent configuration for Anthos Service Mesh managed control plane...

Migrating MeshConfig settings...
✔ Wrote MeshConfig to asm-generated-configs/meshconfig.yaml.

Migrating gateway deployments...

Checking configuration compatibility...
! Found unsupported configurations:
    Components.Base: not configurable in managed control plane
    Components.Pilot: not configurable in managed control plane
    Hub=gcr.io/gke-release/asm: not configurable in managed control plane
    Tag=1.10.4-asm.6: not configurable in managed control plane

Actions required to migrate:
! Found potentially unsupported configurations; review warnings above before proceeding
- Found custom mesh configuration settings. To apply these settings to ASM managed
    control plane, run: `kubectl apply -f 'asm-generated-configs/meshconfig.yaml'`

TIP: steps recommending `kubectl apply` to be run should be integrated into your
  CI/CD pipeline, if applicable.

Étapes suivantes