Apigee 인그레스 게이트웨이로 마이그레이션

이 절차에 따라 기존 Anthos Hybrid v1.8 설치를 인그레스용 Anthos Service Mesh 사용에서 Apigee 인그레스 게이트웨이 사용으로 마이그레이션하세요.

Apigee Hybrid 버전 1.8의 Apigee 인그레스 게이트웨이

Apigee Hybrid는 버전 1.8부터 하이브리드 설치용 인그레스 게이트웨이 Apigee 인그레스 게이트웨이를 관리하는 새로운 기능을 제공합니다. Anthos Service Mesh는 더 이상 하이브리드 설치의 기본 요건이 아니며 Apigee는 Anthos Service Mesh에 라우팅 구성을 제공하지 않습니다. 업그레이드 후에는 트래픽을 새 Apigee 인그레스 게이트웨이로 마이그레이션해야 합니다.

마이그레이션을 위한 두 가지 시나리오는 다음과 같습니다.

멀티 클러스터 또는 멀티 리전 마이그레이션(권장):
새 Apigee용 인그레스로 전환하기 전에 마이그레이션하는 클러스터에서 다른 클러스터 또는 리전으로 모든 트래픽을 드레이닝합니다. 이렇게 하면 새 Apigee 인그레스 게이트웨이가 예상대로 작동하는지 테스트할 수 있습니다. 그런 다음 트래픽을 업그레이드된 클러스터로 다시 전환합니다.
인플레이스 업그레이드(프로덕션 환경에서는 권장되지 않음):
업그레이드하는 동안 Apigee는 새 IP 주소를 사용하여 새 인그레스 게이트웨이를 가져옵니다. 그런 다음 새 Apigee 인그레스 게이트웨이가 예상대로 작동하는지 테스트하고 트래픽을 새 인그레스로 이동할 수 있습니다. 이 업그레이드 중에 다운타임이 발생할 수 있습니다.

Apigee 인그레스 게이트웨이 설치

Apigee 인그레스 게이트웨이를 설치하려면 재정의 파일에 ingressGateways 속성을 추가해야 합니다.
구문
```
ingressGateways:
- name: INGRESS_NAME
  replicaCountMin: REPLICAS_MIN
  replicaCountMax: REPLICAS_MAX
  resources:
    requests:
      cpu: CPU_COUNT_REQ
      memory: MEMORY_REQ
    limits:
      cpu: CPU_COUNT_LIMIT
      memory: MEMORY_LIMIT
  svcAnnotations:  # optional. See Known issue 243599452.
    SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
  svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
예
```
ingressGateways:
- name: prod1
  replicaCountMin: 2
  replicaCountMax: 100
  resources:
    requests:
      cpu: 1
      memory: 1Gi
    limits:
      cpu: 2
      memory: 2Gi
  svcAnnotations:  # optional. See Known issue 243599452.
    networking.gke.io/load-balancer-type: "Internal"
  svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME은 인그레스 게이트웨이 배포의 이름입니다. 다음 요구사항을 충족하는 이름이면 됩니다.
  - 최대 길이는 17자(영문 기준)입니다.
  - 소문자 영숫자 문자, '-' 또는 '.'만 포함해야 합니다.
  - 영숫자 문자로 시작해야 합니다.
  - 영숫자 문자로 끝나야 합니다.
  구성 속성 참조의 ingressGateways[].name을 참조하세요.
- REPLICAS_MIN 및 REPLICAS_MAX: 설치에서 Apigee 인그레스 게이트웨이의 최소 및 최대 복제본 수입니다. 자세한 내용과 기본 설정은 구성 속성 참조의 ingressGateways[].replicaCountMin 및 ingressGateways[].replicaCountMax를 참조하세요.
- CPU_COUNT_REQ 및 MEMORY_REQ: 설치에서 Apigee 인그레스 게이트웨이의 각 복제본에 대한 CPU 및 메모리 요청입니다.
  이러한 속성을 이전에 Anthos Service Mesh 인그레스 게이트웨이에 설정한 경우(예: overlay.yaml파일) 설정합니다.
  
  자세한 내용과 기본 설정은 구성 속성 참조의 ingressGateways[].resources.requests.cpu 및 ingressGateways[].resources.requests.memory를 참조하세요.
- CPU_COUNT_LIMIT 및 MEMORY_LIMIT: 설치에서 Apigee 인그레스 게이트웨이의 각 복제본에 대한 최대 CPU 및 메모리 한도입니다.
  이러한 속성을 이전에 Anthos Service Mesh 인그레스 게이트웨이에 설정한 경우(예: overlay.yaml파일) 설정합니다.
  
  자세한 내용과 기본 설정은 구성 속성 참조의 ingressGateways[].resources.limits.cpu 및 ingressGateways[].resources.limits.memory를 참조하세요.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE(선택사항):
  참고: overrides.yaml의 ingressGateways[].svcAnnotations 필드가 예상대로 작동하지 않습니다. 알려진 문제 243599452를 참조하세요.
  
  기본 인그레스 서비스의 주석을 제공하는 키-값 쌍입니다. 주석은 부하분산기 유형을 내부 또는 외부로 설정하는 등, 클라우드 플랫폼에서 하이브리드 설치를 구성하는 데 사용됩니다. 예를 들면 다음과 같습니다.
```
ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
```
  주석은 플랫폼마다 다릅니다. 필수 및 추천 주석은 플랫폼 문서를 참조하세요.
  
  참고: Apigee 인그레스 게이트웨이 노출에 설명된 대로 인그레스 배포를 위한 자체 Kubernetes 서비스를 만드는 경우 Annotations를 설정할 필요가 없습니다.
  구성 속성 참조의 ingressGateways[].svcAnnotations를 참조하세요.
- SVC_LOAD_BALANCER_IP (선택사항) 부하 분산기에 고정 IP 주소를 할당할 수 있습니다. 부하 분산기 IP 주소 지정을 지원하는 플랫폼에서 이 IP 주소로 부하 분산기가 생성됩니다. 부하 분산기 IP 주소를 지정할 수 없는 플랫폼에서 이 속성은 무시됩니다.
  부하 분산기에 할당된 고정 IP 주소가 없으면 이 속성을 재정의 파일에서 제외하세요.
  
  주의: 현재 istio-ingressgateway와 동일한 IP 주소를 지정하지 마세요. 이로 인해 해당 서비스가 클러스터에 아직 남아 있는 동안 문제가 발생할 수 있습니다.
  참고: Apigee 인그레스 게이트웨이 노출에 설명된 대로 인그레스 배포를 위한 자체 Kubernetes 서비스를 만드는 경우 LoadBalancerIP를 설정할 필요가 없습니다.
  구성 속성 참조의 ingressGateways[].svcLoadBalancerIP를 참조하세요.
다음 명령어를 사용하여 변경사항을 적용하여 Apigee 인그레스 게이트웨이를 설치합니다.
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```

Apigee 인그레스 게이트웨이로 트래픽 전환

트래픽을 Anthos Service Mesh에서 Apigee 인그레스 게이트웨이로 마이그레이션하려면 Apigee Hybrid v1.8로 업그레이드 주제의 Anthos Service Mesh에서 Apigee 인그레스 게이트웨이로 트래픽 전환에 있는 단계를 수행합니다.