Apigee Hybrid를 버전 1.14로 업그레이드

이 절차에서는 Apigee Hybrid 버전 1.13.x에서 Apigee Hybrid 버전 1.14.2 로 업그레이드하고 이전 출시 버전인 Hybrid 1.14.x에서 버전 1.14.2로 업그레이드하는 작업을 다룹니다.

마이너 버전 업그레이드(예: 버전 1.13에서 1.14로)와 패치 출시 버전 업그레이드(예: 1.4.1에서 1.14.2)에 같은 절차를 사용합니다.

Apigee Hybrid 버전 1.12 이하에서 업그레이드하는 경우 버전 Hybrid 버전 1.14.2로 업그레이드하기 전에 버전 1.13으로 업그레이드해야 합니다. Apigee Hybrid를 버전 1.13으로 업그레이드 안내를 참조하세요.

Apigee Hybrid v1.13의 변경사항

다음과 같은 변경사항이 있습니다.

버전 1.14부터 데이터 영역 구성요소는 기본적으로 데이터를 컨트롤 플레인에 직접 씁니다. 이를 통해 분석 및 디버그 데이터의 안정성과 규정 준수가 향상됩니다. 데이터 상주로 애널리틱스 및 디버그 데이터 수집을 참조하세요.
Anthos(베어메탈용 또는 VMware용)가 이제 Google Distributed Cloud(베어메탈용 또는 VMware용)로 변경됨: 자세한 내용은 베어메탈용 Google Distributed Cloud 및 VMware용 Google Distributed Cloud의 제품 개요를 참조하세요.
더 엄격한 클래스 인스턴스화 확인: Apigee Hybrid 버전 1.14.1부터 Java 클래스 인스턴스화를 수행하는 동안 JavaCallout 정책에 추가 보안이 포함됩니다. 강화된 보안 조치를 통해 허용되지 않는 권한이 필요한 작업을 직간접적으로 시도하는 정책의 배포를 방지할 수 있습니다.
대부분의 경우 기존 정책은 문제없이 계속 정상적으로 작동합니다. 하지만 서드 파티 라이브러리를 사용하는 정책이나 높은 권한이 필요한 작업을 간접적으로 트리거하는 커스텀 코드가 있는 정책은 영향을 받을 수 있습니다.

중요: 설치를 테스트하려면 1.14.1로 업그레이드한 후 정책 검증 절차를 수행하여 정책 동작을 검증하세요.

Hybrid 버전 1.14의 기능에 관한 자세한 내용은 Apigee Hybrid v1.14.0 출시 노트를 참조하세요.

기본 요건

Hybrid 버전 1.14로 업그레이드하기 전에 설치가 다음 요구사항을 충족하는지 확인하세요.

Hybrid 설치에서 v1.13보다 이전 버전을 실행하는 경우 v1.14로 업그레이드하기 전에 버전 1.13으로 업그레이드해야 합니다. Apigee Hybrid 버전 1.13으로 업그레이드를 참조하세요.
Helm 버전 v3.14.2 이상
kubectl: Kubernetes 플랫폼 버전에 적합한 지원되는 kubectl 버전입니다. 지원되는 플랫폼 및 버전: kubectl을 참조하세요.
cert-manager: 지원되는 cert-manager 버전입니다. 지원되는 플랫폼 및 버전: cert-manager를 참조하세요. 필요한 경우 아래의 버전 1.14로 업그레이드 준비 섹션에서 cert-manager를 업그레이드합니다.

1.14.2로 업그레이드하기 전 - 제한사항 및 중요 참고사항

Apigee Hybrid 1.14.2에서는 단일 환경에 더 많은 프록시와 공유 흐름을 배포할 수 있는 새로운 환경별 프록시 한도가 도입되었습니다. 환경당 배포할 수 있는 프록시 및 공유 흐름 수에 대한 한도를 알아보려면 한도: API 프록시를 참조하세요. 이 기능은 새로 만든 Hybrid 조직에서만 사용할 수 있으며 업그레이드된 조직에는 적용할 수 없습니다. 이 기능을 사용하려면 Hybrid 1.14.2를 새로 설치하고 새 조직을 만드세요.

이 기능은 2024년 구독 요금제의 일부로만 제공되며 해당 요금제에 따라 부여된 사용 권한이 적용됩니다. 이 기능에 대해 자세히 알아보려면 환경별 프록시 한도 향상을 참조하세요.
Apigee Hybrid 버전 1.14로 업그레이드하려면 다운타임이 필요할 수 있습니다.

Apigee 컨트롤러를 버전 1.14.2로 업그레이드하면 모든 Apigee 배포가 순차적으로 재시작됩니다. 지속적 재시작 중에 프로덕션 하이브리드 환경에서 다운타임을 최소화하려면 클러스터를 최소 두 개 이상(동일하거나 다른 리전/데이터 센터에서)을 실행해야 합니다. 모든 프로덕션 트래픽을 단일 클러스터로 전환하고 오프라인으로 업그레이드하려는 클러스터를 적용한 후 업그레이드 절차를 진행합니다. 클러스터마다 이 절차를 반복합니다.

Apigee에서는 업그레이드를 시작하면 프로덕션에 영향을 미칠 가능성을 줄이기 위해 가능한 한 빨리 모든 클러스터를 업그레이드할 것을 권장합니다. 첫 번째 클러스터를 업그레이드한 후 남은 클러스터를 모두 업그레이드해야 하는 기한은 정해져 있지 않습니다. 그러나 나머지 모든 클러스터가 업그레이드될 때까지 Cassandra 백업 및 복원은 혼합 버전에서 작동하지 않습니다. 예를 들어 Hybrid 1.13의 백업을 사용하여 Hybrid 1.14 인스턴스를 복원할 수 없습니다.
업그레이드 중에 관리 영역 변경사항을 완전히 정지할 필요는 없습니다. 관리 영역 변경사항에 대한 모든 임시 정지는 아래의 업그레이드 안내에 나와 있습니다.

버전 1.14.2로 업그레이드 개요

Apigee Hybrid 업그레이드 절차는 다음과 같은 섹션으로 정리됩니다.

업그레이드를 준비합니다.
Hybrid 런타임 버전 1.14.2를 설치합니다.

버전 1.14로 업그레이드 준비

Hybrid 설치 백업

이 안내에서는 Helm 차트를 설치한 파일 시스템의 디렉터리에 환경 변수 APIGEE_HELM_CHARTS_HOME을 사용합니다. 필요한 경우 디렉터리를 이 디렉터리로 변경하고 다음 명령어를 사용하여 변수를 정의합니다.
Linux
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
MacOS
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Windows
```
set APIGEE_HELM_CHARTS_HOME=%CD%
echo %APIGEE_HELM_CHARTS_HOME%
```
버전 1.13 $APIGEE_HELM_CHARTS_HOME/ 디렉터리의 백업 복사본을 만듭니다. 모든 백업 프로세스를 사용할 수 있습니다. 예를 들어 다음을 사용하여 전체 디렉터리의 tar 파일을 만들 수 있습니다.
```
tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.13-backup.tar.gz $APIGEE_HELM_CHARTS_HOME
```
Cassandra 백업 및 복구의 안내에 따라 Cassandra 데이터베이스를 백업합니다.
중요: 버전 1.14부터 가드레일에 Apigee Hybrid 업그레이드 중에 적용되는 다음과 같은 백업 관련 검사가 포함됩니다.
1. 필요한 경우 이전 버전으로 복원할 수 있도록 백업을 사용 설정해야 합니다.
2. CSI 백업이 사용 설정된 경우 업그레이드하기 전 24시간 이내에 백업을 수행해야 합니다. 이렇게 하면 이전 버전으로 복원해야 하는 경우 발생할 수 있는 데이터 손실을 최소화합니다.
가드레일 검사에 관한 자세한 내용은 가드레일을 참조하세요.

서비스 계정 인증에 대한 재정의에 서비스 인증서 파일(.json)을 사용하는 경우 서비스 계정 인증서 파일이 올바른 Helm 차트 디렉터리에 있는지 확인합니다. Helm 차트는 각 차트 디렉터리 외부의 파일을 읽을 수 없습니다.

Kubernetes 보안 비밀이나 워크로드 아이덴티티를 사용하여 서비스 계정을 인증하는 경우에는 이 단계가 필요하지 않습니다.

다음 표에서는 설치 유형에 따라 각 서비스 계정 파일의 대상을 보여줍니다.

프로덕션

서비스 계정	기본 파일 이름	Helm 차트 디렉터리
`apigee-cassandra`	`PROJECT_ID-apigee-cassandra.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/`
`apigee-logger`	`PROJECT_ID-apigee-logger.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-mart`	`PROJECT_ID-apigee-mart.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-metrics`	`PROJECT_ID-apigee-metrics.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-runtime`	`PROJECT_ID-apigee-runtime.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env`
`apigee-synchronizer`	`PROJECT_ID-apigee-synchronizer.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env/`
`apigee-udca`	`PROJECT_ID-apigee-udca.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-watcher`	`PROJECT_ID-apigee-watcher.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`

비프로덕션

다음 디렉터리 각각에 apigee-non-prod 서비스 계정 파일의 사본을 만듭니다.

서비스 계정	기본 파일 이름	Helm 차트 디렉터리
`apigee-non-prod`	`PROJECT_ID-apigee-non-prod.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/` `$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/` `$APIGEE_HELM_CHARTS_HOME/apigee-org/` `$APIGEE_HELM_CHARTS_HOME/apigee-env/`

TLS 인증서와 키 파일(.crt, .key 또는 .pem)이 $APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/ 디렉터리에 있는지 확인합니다.

Kubernetes 버전 업그레이드

Kubernetes 플랫폼 버전을 확인하고 필요한 경우 Kubernetes 플랫폼을 Hybrid 1.13 및 Hybrid 1.14 모두에서 지원하는 버전으로 업그레이드합니다. 도움이 필요하면 플랫폼 문서를 참조하세요.

클릭하여 지원되는 플랫폼 목록 펼치기

	1.12 ⁽²⁾	1.13	1.14
Google Cloud용 GKE	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	1.27.x 1.28.x 1.29.x 1.30.x	1.28.x 1.29.x 1.30.x 1.31.x
GKE on AWS	1.26.x⁽⁴⁾ 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)} 1.30.x	1.28.x 1.29.x^{(≥ 1.12.1)(8)} 1.30.x 1.31.x
Azure용 GKE	1.26.x⁽⁴⁾ 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)} 1.30.x	1.28.x 1.29.x^{(≥ 1.12.1)(8)} 1.30.x 1.31.x
VMware용 Google Distributed Cloud(소프트웨어 전용) ⁽⁵⁾	1.15.x(K8s v1.26.x) 1.16.x(K8s v1.27.x) 1.28.x⁽⁴⁾ 1.29.x^{(≥ 1.12.1)(8)}	1.16.x(K8s v1.27.x) 1.28.x⁽⁴⁾ 1.29.x 1.30.x	1.28.x⁽⁴⁾ 1.29.x 1.30.x 1.31.x
베어메탈용 Google Distributed Cloud(소프트웨어 전용)	1.15.x(K8s v1.26.x) 1.16.x(K8s v1.27.x) 1.28.x⁽⁴⁾ 1.29.x^{(≥ 1.12.1)(8)}	1.16.x(K8s v1.27.x) 1.28.x⁽⁴⁾ 1.29.x 1.30.x	1.28.x⁽⁴⁾ 1.29.x 1.30.x 1.31.x
EKS	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	1.27.x 1.28.x 1.29.x 1.30.x	1.28.x 1.29.x 1.30.x 1.31.x
AKS	1.26.x 1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	1.27.x 1.28.x 1.29.x 1.30.x	1.28.x 1.29.x 1.30.x 1.31.x
OpenShift⁽⁹⁾	4.12 4.13 4.14 4.15 4.16^{(≥ 1.12.1)(8)}	4.12 4.13 4.14 4.15 4.16	4.13 4.14 4.15 4.16 4.17
Rancher Kubernetes Engine(RKE)	v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x^{(≥ 1.12.1)(8)}	v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x 1.30.x	v1.27.x 1.28.x 1.29.x 1.30.x 1.31.x
VMware Tanzu	v1.26.x	v1.26.x	v1.26.x
구성요소	1.12 ⁽²⁾	1.13	1.14
Cloud Service Mesh	1.18.x⁽³⁾	1.19.x⁽³⁾	1.22.x⁽³⁾
JDK	JDK 11	JDK 11	JDK 11
cert-manager	1.11.x 1.12.x 1.13.x	1.13.x 1.14.x 1.15.x⁽¹⁰⁾	1.14.x 1.15.x⁽¹⁰⁾ 1.16.x⁽¹⁰⁾
Cassandra	4.0	4.0	4.0
Kubernetes	1.26.x 1.27.x 1.28.x 1.29.x	1.27.x 1.28.x 1.29.x 1.30.x	1.28.x 1.29.x 1.30.x 1.31.x
kubectl	1.26.x 1.27.x 1.28.x 1.29.x	1.27.x 1.28.x 1.29.x 1.30.x	1.28.x 1.29.x 1.30.x 1.31.x
Helm	3.14.2+	3.14.2+	3.14.2+
Secret Store CSI 드라이버	1.4.1	1.4.1	1.4.6
Vault	1.15.2	1.15.2	1.17.2
⁽¹⁾ Anthos 온프레미스(Google Distributed Cloud) 버전 1.13에서 `cert-manager`와 충돌을 방지하려면 다음 안내를 따르세요. cert-manager 설치 충돌 ⁽²⁾ Apigee Hybrid 버전 1.12 이하의 공식 EOL 날짜에 도달했습니다. 일반 월간 패치는 더 이상 제공되지 않습니다. 지속적인 지원에 대한 명시적인 공식 예외가 적용되는 고객을 제외하고 이 출시 버전은 더 이상 공식적으로 지원되지 않습니다. 다른 고객은 업그레이드해야 합니다. ⁽³⁾ Cloud Service Mesh는 Apigee hybrid 1.9 이상에 자동으로 설치됩니다. ⁽⁴⁾ 이제 AWS용 GKE 버전 번호에 Kubernetes 버전이 반영됩니다. 버전 세부정보 및 권장되는 패치는 GKE Enterprise 버전 및 업그레이드 지원을 참조하세요. ⁽⁵⁾ Vault는 VMware용 Google Distributed Cloud에서 인증되지 않습니다. ⁽⁶⁾ Apigee hybrid 버전 1.10.5 이상에서 지원을 사용할 수 있습니다. ⁽⁷⁾ Apigee hybrid 버전 1.11.2 이상에서 지원을 사용할 수 있습니다. ⁽⁸⁾ Apigee hybrid 버전 1.12.1 이상에서 지원을 사용할 수 있습니다. ⁽⁹⁾ Apigee Hybrid는 각 특정 OCP 버전에 번들로 제공되는 Kubernetes 버전을 사용하여 OpenShift에서 테스트하고 인증합니다. ⁽¹⁰⁾ 일부 버전의 cert-manager에는 웹훅 TLS 서버가 CA 인증서를 자동으로 갱신하지 못할 수 있는 문제가 있습니다. 이를 방지하려면 Apigee에서 다음을 권장합니다. Hybrid v1.13: cert-manager 버전 1.15.5 이상을 사용합니다. Hybrid v1.14: cert-manager 버전 1.15.5 이상 또는 1.16.3 이상을 사용합니다.

Hybrid 1.14.2 런타임 설치

데이터 수집 파이프라인을 구성합니다.

Hybrid v1.14부터 모든 Apigee Hybrid 조직에 새 분석 및 디버그 데이터 파이프라인이 기본적으로 사용 설정됩니다. 분석 게시자 액세스 사용 설정의 단계에 따라 승인 흐름을 구성해야 합니다.

Helm 차트 업그레이드 준비

Apigee Helm 차트를 가져옵니다.

Apigee Hybrid 차트는 Google Artifact Registry에서 호스팅됩니다.

oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts

pull 명령어를 사용하여 다음 명령어로 모든 Apigee Hybrid Helm 차트를 로컬 스토리지에 복사합니다.

export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
export CHART_VERSION=1.14.2-hotfix.1
helm pull $CHART_REPO/apigee-operator --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-datastore --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-env --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-ingress-manager --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-org --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-redis --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-telemetry --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-virtualhost --version $CHART_VERSION --untar

필요한 경우 cert-manager를 업그레이드합니다.
cert-manager 버전을 업그레이드해야 하는 경우 다음 명령어를 사용하여 새 버전을 설치합니다.
```
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.16.3/cert-manager.yaml
```
지원되는 버전 목록은 지원되는 플랫폼 및 버전: cert-manager를 참조하세요.

참고: 일부 버전의 cert-manager에는 웹훅 TLS 서버가 CA 인증서를 자동으로 갱신하지 못할 수 있는 문제가 있습니다. 이를 방지하려면 Apigee에서 cert-manager 버전 1.15.5 이상 또는 1.16.3 이상을 사용하는 것이 좋습니다.
Apigee 네임스페이스가 apigee가 아니면 apigee-operator/etc/crds/default/kustomization.yaml 파일을 수정하고 namespace 값을 Apigee 네임스페이스로 바꿉니다.
```
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

namespace: APIGEE_NAMESPACE
```
apigee를 네임스페이스로 사용하는 경우 파일을 수정할 필요가 없습니다.

업데이트된 Apigee CRD를 설치합니다.

참고: Apigee CRD를 설치하는 데 지원되는 유일한 방법입니다. -k 없이 kubectl apply를 사용하지 말고 --server-side를 생략하지 마세요.

다음 명령어를 실행하여 kubectl 테스트 실행 기능을 사용합니다.

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false --dry-run=server

테스트 실행 명령어로 유효성을 검사한 후 다음 명령어를 실행합니다.

kubectl apply -k  apigee-operator/etc/crds/default/ \
  --server-side \
  --force-conflicts \
  --validate=false

kubectl get crds 명령어를 사용하여 설치를 검증합니다.

kubectl get crds | grep apigee

출력이 다음과 같이 표시됩니다.

apigeedatastores.apigee.cloud.google.com                    2024-08-21T14:48:30Z
apigeedeployments.apigee.cloud.google.com                   2024-08-21T14:48:30Z
apigeeenvironments.apigee.cloud.google.com                  2024-08-21T14:48:31Z
apigeeissues.apigee.cloud.google.com                        2024-08-21T14:48:31Z
apigeeorganizations.apigee.cloud.google.com                 2024-08-21T14:48:32Z
apigeeredis.apigee.cloud.google.com                         2024-08-21T14:48:33Z
apigeerouteconfigs.apigee.cloud.google.com                  2024-08-21T14:48:33Z
apigeeroutes.apigee.cloud.google.com                        2024-08-21T14:48:33Z
apigeetelemetries.apigee.cloud.google.com                   2024-08-21T14:48:34Z
cassandradatareplications.apigee.cloud.google.com           2024-08-21T14:48:35Z

클러스터 노드의 라벨을 확인합니다. 기본적으로 Apigee는 cloud.google.com/gke-nodepool=apigee-data 라벨이 있는 노드의 데이터 포드를 예약하고 런타임 포드는 cloud.google.com/gke-nodepool=apigee-runtime 라벨이 있는 노드에 예약됩니다. overrides.yaml 파일에서 노드 풀 라벨을 맞춤설정할 수 있습니다.

자세한 내용은 전용 노드 풀 구성을 참조하세요.
선택사항: OAS 사양에서 :additionalProperties: true를 설정하는 것과 함께 allOf 결합자를 사용하도록 허용해야 하는 경우 이 단계를 수행합니다. 재정의 파일에서 runtime 스탠자를 추가하거나 업데이트하여 OAS 사양에서 allOf 결합자를 사용할 수 있도록 합니다. 자세한 내용은 Apigee Hybrid v1.14.2-hotfix.1 출시 노트를 참고하세요.
```
runtime:
  cwcAppend:
    conf_message-processor-communication_oas.disable.resolve.combinator: true
```

Apigee Hybrid Helm 차트 설치

참고: Helm 업그레이드/설치 명령어를 실행하기 전에 명령어 끝에 --dry-run를 추가하여 Helm 테스트 실행 기능을 사용하세요. 지원되는 명령어, 옵션, 사용량을 나열하려면 helm -h를 확인하세요.

그렇지 않은 경우에는 APIGEE_HELM_CHARTS_HOME 디렉터리로 이동합니다. 해당 디렉터리에서 다음 명령어를 실행합니다.

Apigee Operator/Controller를 업그레이드합니다.

참고: 이 단계에는 승격된 클러스터 권한이 필요합니다. 자세한 내용은 helm -h 또는 helm upgrade -h를 실행하세요.

테스트 실행을 수행합니다.

helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server

차트를 업그레이드합니다.

helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

Apigee 운영자 설치를 확인합니다.

helm ls -n APIGEE_NAMESPACE

NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                   APP VERSION
operator   apigee   3          2024-08-21 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.14.2   1.14.2

가용성을 확인하여 실행 중인지 확인합니다.

kubectl -n APIGEE_NAMESPACE get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

Apigee Datastore를 업그레이드합니다.

테스트 실행을 수행합니다.

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server

차트를 업그레이드합니다.

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

상태를 확인하여 apigeedatastore가 실행 중인지 확인합니다.

kubectl -n APIGEE_NAMESPACE get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Apigee 원격 분석을 업그레이드합니다.

테스트 실행을 수행합니다.

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server

차트를 업그레이드합니다.

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

상태를 확인하여 실행 중인지 확인합니다.

kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

Apigee Redis를 업그레이드합니다.

테스트 실행을 수행합니다.

helm upgrade redis apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server

차트를 업그레이드합니다.

helm upgrade redis apigee-redis/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

상태를 확인하여 실행 중인지 확인합니다.

kubectl -n APIGEE_NAMESPACE get apigeeredis default

NAME      STATE     AGE
default   running   2d

Apigee 인그레스 관리자를 업그레이드합니다.

테스트 실행을 수행합니다.

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server

차트를 업그레이드합니다.

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

가용성을 확인하여 실행 중인지 확인합니다.

kubectl -n APIGEE_NAMESPACE get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

Apigee 조직을 업그레이드합니다.
테스트 실행을 수행합니다.
```
helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE \
  --dry-run=server
```
차트를 업그레이드합니다.
```
helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE
```
해당 조직의 상태를 확인하여 실행 중인지 확인합니다.
```
kubectl -n APIGEE_NAMESPACE get apigeeorg
```
```
NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d
```
참고: 업그레이드 명령어가 Forbidden: state: releasing 오류 메시지와 함께 실패하더라도 기존 구성요소는 여전히 출시 상태입니다. 현재 업데이트가 완료될 때까지 기다린 후 다시 시도할 수 있습니다. 다음 명령어로 출시 상태를 확인합니다.
```
kubectl get org -n APIGEE_NAMESPACE
```
환경을 업그레이드합니다.
한 번에 환경 하나만 설치해야 합니다. --set env=ENV_NAME으로 환경을 지정합니다.

테스트 실행을 수행합니다.
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server
```
- ENV_RELEASE_NAME은 apigee-env 차트 설치 및 업그레이드를 추적하는 데 사용되는 이름입니다. 이 이름은 설치 내 다른 Helm 출시 이름과 다르게 고유해야 합니다. 일반적으로 ENV_NAME과 동일합니다. 그러나 환경 이름이 환경 그룹 이름과 같으면 환경과 환경 그룹에 서로 다른 출시 이름(예: dev-env-release 및 dev-envgroup-release)을 사용해야 합니다. Helm의 출시 버전에 대한 자세한 내용은 Helm 문서의 세 가지 주요 개념 class="external"을 참조하세요.
- ENV_NAME은 업그레이드하는 환경의 이름입니다.
- OVERRIDES_FILE은 v.1.14.2의 새로운 재정의 파일입니다.
차트를 업그레이드합니다.
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
해당 환경의 상태를 확인하여 실행 중인지 확인합니다.
```
kubectl -n APIGEE_NAMESPACE get apigeeenv
```
```
NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d
```

참고: 업그레이드 명령어가 Forbidden: state: releasing 오류 메시지와 함께 실패하더라도 기존 구성요소는 아직 출시 상태입니다. 현재 업데이트가 완료될 때까지 기다린 후 다시 시도할 수 있습니다. 다음 명령어로 출시 상태를 확인합니다.

kubectl get env -n APIGEE_NAMESPACE

환경 그룹(virtualhosts)을 업그레이드합니다.
1. 한 번에 환경 그룹(virtualhost) 하나만 설치해야 합니다. --set envgroup=ENV_GROUP_NAME으로 환경 그룹을 지정합니다. override.yaml 파일에 언급된 환경 그룹마다 다음 명령어를 반복합니다.
  테스트 실행을 수행합니다.
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server
```
  ENV_GROUP_RELEASE_NAME은 이전에 apigee-virtualhost 차트를 설치한 이름입니다. 일반적으로 ENV_GROUP_NAME입니다.
  
  차트를 업그레이드합니다.
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE
```
  참고: ENV_GROUP_RELEASE_NAME은 apigee 네임스페이스 내에서 고유해야 합니다.
  예를 들어 prod라는 환경과 prod라는 환경 그룹이 있는 경우 ENV_GROUP_RELEASE_NAME의 값을 고유한 값(예: prod-envgroup)으로 설정합니다.
2. ApigeeRoute(AR) 상태를 확인합니다.
  virtualhosts를 설치하면 Apigee 감시자가 제어 영역에서 환경 그룹 관련 세부정보를 가져온 후 내부적으로 ApigeeRoute(AR)를 만드는 ApigeeRouteConfig(ARC)가 생성됩니다. 따라서 해당 AR 상태가 실행 중인지 확인합니다.
```
kubectl -n APIGEE_NAMESPACE get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n APIGEE_NAMESPACE get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```
모든 설치가 성공적으로 업그레이드되었는지 확인한 후 apigee-system 네임스페이스에서 이전 apigee-operator 버전을 삭제합니다.
1. 이전 operator 버전을 제거합니다.
```
helm delete operator -n apigee-system
```
2. apigee-system 네임스페이스를 삭제합니다.
```
kubectl delete namespace apigee-system
```
삭제된 클러스터 범위 리소스를 다시 설치하려면 Apigee 네임스페이스에서 operator을 다시 업그레이드합니다.
```
helm upgrade operator apigee-operator/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides.yaml
```

1.14.1로 업그레이드한 후 정책 검증

1.14.0 이하에서 1.14.1 이상으로 업그레이드한 후 다음 절차를 수행하여 JavaCallout 정책 동작을 검증합니다.

Java JAR 파일이 불필요한 권한을 요청하는지 확인
정책을 배포한 후 런타임 로그에서 "Failed to load and initialize class ..." 로그 메시지가 있는지 확인합니다. 이 메시지가 표시되면 배포된 JAR가 불필요한 권한을 요청한 것입니다. 이 문제를 해결하려면 Java 코드를 조사하고 JAR 파일을 업데이트하세요.
Java 코드를 조사하고 업데이트합니다.
Java 코드(종속 항목 포함)를 검토하여 허용되지 않을 수 있는 작업의 원인을 파악합니다. 문제가 발견되면 필요에 따라 소스 코드를 수정합니다.
보안 검사가 사용 설정된 정책을 테스트합니다.
비프로덕션 환경에서 보안 확인 플래그를 사용 설정하고 업데이트된 JAR로 정책을 재배포합니다. 플래그를 설정하려면 다음 안내를 따르세요.
- apigee-env/values.yaml 파일에서 runtime:cwcAppend: 아래에 conf_security-secure.constructor.only를 true로 설정합니다. 예를 들면 다음과 같습니다.
```
# Apigee Runtime
runtime:
  cwcAppend:
    conf_security-secure.constructor.only: true
```
- 환경의 apigee-env 차트를 업데이트하여 변경사항을 적용합니다. 예를 들면 다음과 같습니다.
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
"Failed to load and initialize class ..." 로그 메시지가 계속 표시되면 로그 메시지가 더 이상 표시되지 않을 때까지 JAR을 수정하고 테스트합니다.
프로덕션 환경에서 보안 검사를 사용 설정합니다.
비프로덕션 환경에서 JAR 파일을 철저히 테스트하고 확인했으면 conf_security-secure.constructor.only 플래그를 true로 설정하고 프로덕션 환경의 apigee-env 차트를 업데이트하여 변경사항을 적용함으로써 프로덕션 환경에서 보안 검사를 사용 설정합니다.

이전 버전으로 롤백

이전 버전으로 롤백하려면 이전 차트 버전을 사용하여 업그레이드 프로세스를 역순으로 롤백합니다. apigee-virtualhost로 시작하여 apigee-operator로 돌아간 다음 CRD를 되돌립니다.

도움말: 마지막 출시 버전을 알고 있는 경우 아래에 설명된 helm upgrade 명령어 대신 helm rollback 명령어를 사용할 수 있습니다.

모든 차트를 apigee-virtualhost에서 apigee-datastore로 되돌립니다. 다음 명령어는 이전 버전(v1.13.x)의 차트를 사용한다고 가정합니다.

각 환경 그룹에 대해 다음 명령어를 실행합니다.

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f 1.13_OVERRIDES_FILE

각 환경에 대해 다음 명령어를 실행합니다.

helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f 1.13_OVERRIDES_FILE

apigee-operator를 제외한 나머지 차트를 되돌립니다.

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f 1.13_OVERRIDES_FILE

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f 1.13_OVERRIDES_FILE

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f 1.13_OVERRIDES_FILE

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f 1.13_OVERRIDES_FILE

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f 1.13_OVERRIDES_FILE

apigee-system 네임스페이스를 만듭니다.
```
kubectl create namespace apigee-system
```

리소스 주석을 다시 apigee-system 네임스페이스에 패치합니다.

kubectl annotate --overwrite clusterIssuer apigee-ca-issuer meta.helm.sh/release-namespace='apigee-system'

출시 이름도 변경한 경우 주석을 operator 출시 이름으로 업데이트합니다.

kubectl annotate --overwrite clusterIssuer apigee-ca-issuer meta.helm.sh/release-name='operator'

apigee-operator를 apigee-system 네임스페이스에 다시 설치합니다.

helm upgrade operator apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f 1.13_OVERRIDES_FILE

이전 CRD를 재설치하여 CRD를 되돌립니다.

kubectl apply -k apigee-operator/etc/crds/default/ \
  --server-side \
  --force-conflicts \
  --validate=false

APIGEE_NAMESPACE 네임스페이스에서 apigee-operator 출시를 삭제하여 롤백 프로세스를 완료합니다.
```
helm uninstall operator -n APIGEE_NAMESPACE
```
operator가 제거되면 clusterIssuer와 같은 일부 클러스터 범위 리소스가 삭제됩니다. 다음 명령어를 사용하여 다시 설치합니다.
```
helm upgrade operator apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f 1.13_OVERRIDES_FILE
```

Apigee Hybrid를 버전 1.14로 업그레이드 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Apigee Hybrid v1.13의 변경사항

기본 요건

1.14.2로 업그레이드하기 전 - 제한사항 및 중요 참고사항

버전 1.14.2로 업그레이드 개요

버전 1.14로 업그레이드 준비

Hybrid 설치 백업

Linux

MacOS

Windows

프로덕션

비프로덕션

Kubernetes 버전 업그레이드

클릭하여 지원되는 플랫폼 목록 펼치기

구성요소

Hybrid 1.14.2 런타임 설치

데이터 수집 파이프라인을 구성합니다.

Helm 차트 업그레이드 준비

Apigee Hybrid Helm 차트 설치

1.14.1로 업그레이드한 후 정책 검증

이전 버전으로 롤백

Apigee Hybrid를 버전 1.14로 업그레이드