IstioOperator에서 마이그레이션

관리형 컨트롤 플레인에서 맞춤설정할 수 있는 IstioOperator를 직접 지원하지 않습니다. Cloud Service Mesh에서 관리형 컨트롤 플레인으로 마이그레이션하려면 IstioOperator에서 수동으로 변환해야 합니다. 이 도구는 프로세스를 자동화하여 불편함을 줄이는 데 도움이 됩니다.

마이그레이션 도구 정보

마이그레이션 도구는 제공된 IstioOperator 파일을 비파괴적으로 평가하여 다음을 수행합니다.

  • 호환성 문제를 확인합니다.
  • 호환되는 IstioOperator 구성을 관리형 컨트롤 플레인에서 지원하는 구성으로 변환하여 새 구성을 파일로 출력합니다.
  • 관리형 컨트롤 플레인에 필요한 기본값과 충돌하는 구성 값에 대한 경고를 출력합니다.
  • 생성된 파일을 사용하는 방법을 권장합니다.

이 도구는 클러스터 데이터 또는 구성을 검사하지 않으며 클러스터 구성을 변경하지 않습니다. 생성된 모든 파일을 별도로 적용해야 합니다.

마이그레이션 도구를 사용하기 전에 관리형 컨트롤 플레인 지원 기능의 제한사항을 확인하여 관리형 컨트롤 플레인에서 Cloud Service Mesh 설치를 지원하는지 확인합니다.

마이그레이션 도구 사용

마이그레이션 도구는 asmcli 스크립트의 일부로 제공됩니다. 이 도구를 사용하려면 스크립트를 다운로드해야 합니다.

  1. 마이그레이션 도구를 실행합니다.

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

  2. 나열된 파일, 특히 asm/*meshconfig.yaml 및 asm/gateways*가 도구에서 출력됩니다.

  3. 구성 경고를 조사합니다.

  4. 출력을 검토하고 마이그레이션에 필요한 조치를 따릅니다.

지원되지 않는 MeshConfig 필드

관리형 컨트롤 플레인에서 MeshConfig의 다음 필드를 재정의합니다.

  • trustDomain
  • trustDomainAliases
  • configSources
  • defaultConfig.proxyMetadata - 이 특정 필드는 재정의됩니다. 새 필드를 추가할 수 있습니다.
    • XDS_ROOT_CA
    • CA_ROOT_CA
    • OUTPUT_CERTS
    • XDS_AUTH_PROVIDER
    • PROXY_CONFIG_XDS_AGENT
  • defaultConfig.meshId
  • defaultConfig.discoveryAddress

출력 예

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

다음 단계