Von IstioOperator migrieren

Die verwaltete Steuerungsebene unterstützt IstioOperator zur Anpassung nicht direkt. Die Migration von Cloud Service Mesh zur verwalteten Steuerungsebene erfordert eine manuelle Konvertierung von einem IstioOperator-Objekt. Dieses Tool automatisiert diesen Prozess, um dies zu vereinfachen.

Informationen zum Migrationstool

Das Migrationstool wertet die bereitgestellte IstioOperator-Datei destruktiv aus, um Folgendes zu erreichen:

  • Auf Kompatibilitätsprobleme geprüft werden kann.
  • Konvertieren Sie kompatible IstioOperator-Konfigurationen in Konfigurationen, die von der verwalteten Steuerungsebene unterstützt werden. Die neuen Konfigurationen werden in Dateien ausgegeben.
  • Ausgabewarnungen zu Konfigurationswerten, die mit Standardwerten in Konflikt stehen würden, die von der verwalteten Steuerungsebene erforderlich sind.
  • Empfohlen wird, wie die generierten Dateien verwendet werden sollen.

Dieses Tool untersucht keine Clusterdaten oder -konfigurationen und nimmt auch keine Änderungen an einer Clusterkonfiguration vor. Sie müssen alle generierten Dateien separat anwenden.

Prüfen Sie vor der Verwendung des Migrationstools die Einschränkungen für Features, die von der verwalteten Steuerungsebene unterstützt werden, um zu prüfen, ob die verwaltete Steuerungsebene Ihre Installation von Cloud Service Mesh unterstützt.

Migrationstool verwenden

Das Migrationstool ist als Teil des Skripts asmcli verfügbar. Sie müssen das Skript herunterladen, um dieses Tool verwenden zu können.

  1. Führen Sie das Migrationstool aus:

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

  2. Beachten Sie die vom Tool ausgegebenen aufgelisteten Dateien, insbesondere asm/*meshconfig.yaml und asm/gateways*.

  3. Untersuchen Sie die Konfigurationswarnungen.

  4. Prüfen Sie die Ausgabe und folgen Sie den erforderlichen Aktionen für die Migration.

Nicht unterstützte MeshConfig-Felder

Die folgenden Felder in MeshConfig werden von der verwalteten Steuerungsebene überschrieben.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata: Diese spezifischen Felder werden überschrieben. Sie können neue Felder hinzufügen:
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

Beispielausgabe

$ 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.

Nächste Schritte