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, vérifiez les limites 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 l'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.
Exécutez l'outil de migration :
asmcli experimental mcp-migrate-check -f path/to/istiooperator.yaml
Notez les fichiers répertoriés par l'outil, en particulier
asm/*meshconfig.yaml
etasm/gateways*
.Examinez les avertissements de configuration.
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
- Apprenez-en plus sur les fonctionnalités compatibles avec le plan de contrôle géré.