본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

운영자와 함께 업그레이드하십시오

01/30/2023 기여자

PDF

운영자를 사용하여 기존 Astra Trident 설치를 쉽게 업그레이드할 수 있습니다.

필요한 것

연산자를 사용하여 업그레이드하려면 다음 조건이 충족되어야 합니다.

CSI 기반 Astra Trident가 설치되어 있어야 합니다. CSI Trident를 실행 중인지 확인하려면 Trident 네임스페이스의 Pod를 확인하십시오. 에 따릅니다 trident-csi-* 명명 패턴에서 CSI Trident를 실행하고 있습니다.
CRD 기반 Trident가 설치되어 있어야 합니다. 이는 19.07 이후의 모든 릴리스를 나타냅니다. CSI 기반 설치가 있는 경우 CRD 기반 설치가 있을 가능성이 높습니다.
CSI Trident를 제거한 후 설치 시 메타데이터가 지속되는 경우 연산자를 사용하여 업그레이드할 수 있습니다.
주어진 Kubernetes 클러스터의 모든 네임스페이스에 하나의 Astra Trident 설치만 존재해야 합니다.
를 실행하는 Kubernetes 클러스터를 사용해야 합니다 "지원되는 Kubernetes 버전".
알파 스냅샷 CRD가 있는 경우 를 사용하여 제거해야 합니다 tridentctl obliviate alpha-snapshot-crd. 그러면 알파 스냅샷 사양에 대한 CRD가 삭제됩니다. 삭제/마이그레이션해야 하는 기존 스냅샷의 경우 를 참조하십시오 "블로그입니다".

OpenShift Container Platform에서 연산자를 사용하여 Trident를 업그레이드할 때는 Trident 21.01.1 이상으로 업그레이드해야 합니다. 21.01.0으로 릴리스된 Trident 연산자에는 21.01.1에서 해결된 알려진 문제가 포함되어 있습니다. 자세한 내용은 를 참조하십시오 "GitHub에 대한 발행 세부 정보".

클러스터 범위 운영자 설치를 업그레이드하십시오

다음 단계에 따라 * Trident 21.01 이상에서 업그레이드합니다 *.

단계

현재 Astra Trident 인스턴스를 설치하는 데 사용된 Trident 연산자를 삭제합니다. 예를 들어, 21.01에서 업그레이드하는 경우 다음 명령을 실행합니다.
```
kubectl delete -f 22.01/trident-installer/deploy/BUNDLE.YAML -n trident
```
필요에 따라 를 편집할 수 있습니다 TridentOrchestrator Trident를 설치할 때 생성한 객체를 선택하여 설치 매개 변수를 수정합니다. 여기에는 사용자 지정 Trident 이미지 수정, 컨테이너 이미지를 가져올 전용 이미지 레지스트리, 디버그 로그 활성화 또는 이미지 풀 암호 지정 등의 변경 사항이 포함될 수 있습니다.

사용자 환경에 맞는 올바른 번들 YAML 파일과 의 Astra Trident 버전을 사용하여 Astra Trident를 설치합니다 https://github.com/NetApp/trident/tree/stable/vXX.XX/deploy/BUNDLE.YAML 위치 vXX.XX 은 버전 번호입니다(예 v22.10) 및 BUNDLE.YAML 번들 YAML 파일 이름입니다.

Kubernetes 1.24 이하 를 실행하는 클러스터의 경우, 를 사용합니다 "Bundle_PRE_1_25.YAML".
Kubernetes 1.25 이상을 실행하는 클러스터의 경우 를 사용합니다 "Bundle_post_1_25.YAML".

예를 들어, Kubernetes 1.25용 Astra Trident 22.10을 설치하는 경우 다음 명령을 실행합니다.

kubectl create -f 22.10.0/trident-installer/deploy/bundle_post_1_25.yaml -n trident

이 단계의 일부로 Trident 운영자는 기존 Astra Trident 설치를 식별하고 운영자와 동일한 버전으로 업그레이드합니다.

네임스페이스 범위 연산자 설치를 업그레이드합니다

네임스페이스 범위 연산자(버전 20.07 ~ 20.10)를 사용하여 설치된 Astra Trident의 인스턴스에서 업그레이드하려면 다음 단계를 따라야 합니다.

단계

기존 Trident 설치의 상태를 확인합니다. 이렇게 하려면 의 * 상태 * 를 확인하십시오 TridentProvisioner. 상태는 입니다 Installed.
```
kubectl describe tprov trident -n trident | grep Message: -A 3
Message:  Trident installed
Status:   Installed
Version:  v20.10.1
```
상태가 표시되는 경우 `Updating`계속하기 전에 이 문제를 해결하십시오. 가능한 상태 값 목록은 를 참조하십시오 "여기".

를 생성합니다 TridentOrchestrator Trident 설치 프로그램과 함께 제공된 매니페스트를 사용하여 CRD를 만듭니다.

# Download the release required [22.10.0]
mkdir 22.10.0
cd 22.10.0
wget https://github.com/NetApp/trident/releases/download/v22.10.0/trident-installer-22.10.0.tar.gz
tar -xf trident-installer-22.10.0.tar.gz
cd trident-installer
kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml

매니페스트를 사용하여 네임스페이스 범위 연산자를 삭제합니다. 이 단계를 완료하려면 에서 네임스페이스 범위 연산자를 배포하는 데 사용되는 번들 YAML 파일이 필요합니다 https://github.com/NetApp/trident/tree/stable/vXX.XX/deploy/BUNDLE.YAML 위치 vXX.XX 은 버전 번호입니다(예 v22.10) 및 BUNDLE.YAML 번들 YAML 파일 이름입니다.

Trident 설치 매개 변수를 필요에 따라 변경해야 합니다(예: 의 값 변경) tridentImage, autosupportImage`개인 이미지 저장소 및 제공 `imagePullSecrets) 네임스페이스 범위 연산자를 삭제한 후 클러스터 범위 연산자를 설치하기 전에 먼저 . 업데이트할 수 있는 전체 매개 변수 목록은 을 참조하십시오 "구성 옵션".

#Ensure you are in the right directory
pwd
/root/20.10.1/trident-installer

#Delete the namespace-scoped operator
kubectl delete -f deploy/<BUNDLE.YAML>
serviceaccount "trident-operator" deleted
clusterrole.rbac.authorization.k8s.io "trident-operator" deleted
clusterrolebinding.rbac.authorization.k8s.io "trident-operator" deleted
deployment.apps "trident-operator" deleted
podsecuritypolicy.policy "tridentoperatorpods" deleted

#Confirm the Trident operator was removed
kubectl get all -n trident
NAME                               READY   STATUS    RESTARTS   AGE
pod/trident-csi-68d979fb85-dsrmn   6/6     Running   12         99d
pod/trident-csi-8jfhf              2/2     Running   6          105d
pod/trident-csi-jtnjz              2/2     Running   6          105d
pod/trident-csi-lcxvh              2/2     Running   8          105d

NAME                  TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)              AGE
service/trident-csi   ClusterIP   10.108.174.125   <none>        34571/TCP,9220/TCP   105d

NAME                         DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR                                     AGE
daemonset.apps/trident-csi   3         3         3       3            3           kubernetes.io/arch=amd64,kubernetes.io/os=linux   105d

NAME                          READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/trident-csi   1/1     1            1           105d

NAME                                     DESIRED   CURRENT   READY   AGE
replicaset.apps/trident-csi-68d979fb85   1         1         1       105d

이 단계에서는 를 선택합니다 trident-operator-xxxxxxxxxx-xxxxx POD가 삭제되었습니다.

(선택 사항) 설치 매개 변수를 수정해야 하는 경우 를 업데이트합니다 TridentProvisioner 사양 컨테이너 이미지를 가져올 전용 이미지 레지스트리를 수정하거나, 디버그 로그를 사용하거나, 이미지 풀 비밀을 지정하는 등의 변경 사항이 있을 수 있습니다.
```
kubectl patch tprov <trident-provisioner-name> -n <trident-namespace> --type=merge -p '{"spec":{"debug":true}}'
```

클러스터 범위 연산자를 설치합니다.

클러스터 범위 연산자를 설치하면 마이그레이션이 시작됩니다 TridentProvisioner 개체 대상 TridentOrchestrator 오브젝트, 삭제 TridentProvisioner 개체 및 tridentprovisioner CRD를 사용하여 Astra Trident를 사용 중인 클러스터 범위 운영자 버전으로 업그레이드합니다. 다음 예제에서 Trident는 22.10.0으로 업그레이드됩니다.

클러스터 범위 연산자를 사용하여 Astra Trident를 업그레이드하면 가 마이그레이션됩니다 tridentProvisioner A로 tridentOrchestrator 같은 이름의 개체입니다. 이 작업은 작업자가 자동으로 처리합니다. 업그레이드에는 이전과 동일한 네임스페이스에 Astra Trident도 설치됩니다.

#Ensure you are in the correct directory
pwd
/root/22.10.0/trident-installer

#Install the cluster-scoped operator in the **same namespace**
kubectl create -f deploy/<BUNDLE.YAML>
serviceaccount/trident-operator created
clusterrole.rbac.authorization.k8s.io/trident-operator created
clusterrolebinding.rbac.authorization.k8s.io/trident-operator created
deployment.apps/trident-operator created
podsecuritypolicy.policy/tridentoperatorpods created

#All tridentProvisioners will be removed, including the CRD itself
kubectl get tprov -n trident
Error from server (NotFound): Unable to list "trident.netapp.io/v1, Resource=tridentprovisioners": the server could not find the requested resource (get tridentprovisioners.trident.netapp.io)

#tridentProvisioners are replaced by tridentOrchestrator
kubectl get torc
NAME      AGE
trident   13s

#Examine Trident pods in the namespace
kubectl get pods -n trident
NAME                                READY   STATUS    RESTARTS   AGE
trident-csi-79df798bdc-m79dc        6/6     Running   0          1m41s
trident-csi-xrst8                   2/2     Running   0          1m41s
trident-operator-5574dbbc68-nthjv   1/1     Running   0          1m52s

#Confirm Trident has been updated to the desired version
kubectl describe torc trident | grep Message -A 3
Message:                Trident installed
Namespace:              trident
Status:                 Installed
Version:                v22.10.0

제어 기반 작업자 설치를 업그레이드합니다

제어 기반 운영자 설치를 업그레이드하려면 다음 단계를 수행하십시오.

단계

최신 Astra Trident 릴리스를 다운로드하십시오.
를 사용합니다 helm upgrade 명령. 다음 예를 참조하십시오.
```
helm upgrade <name> trident-operator-22.10.0.tgz
```
위치 trident-operator-22.10.0.tgz 업그레이드하려는 버전을 반영합니다.
실행 helm list 차트와 앱 버전이 모두 업그레이드되었는지 확인합니다.

업그레이드 중에 구성 데이터를 전달하려면 를 사용합니다 --set.

예를 들어, 의 기본값을 변경합니다 `tridentDebug`에서 다음 명령을 실행합니다.

helm upgrade <name> trident-operator-22.10.0-custom.tgz --set tridentDebug=true

을(를) 실행하는 경우 `tridentctl logs`디버그 메시지를 볼 수 있습니다.

초기 설치 중에 기본값이 아닌 옵션을 설정하는 경우 업그레이드 명령에 옵션이 포함되어 있는지 확인하십시오. 그렇지 않으면 값이 기본값으로 재설정됩니다.

비운영자 설치에서 업그레이드

위에 나열된 필수 조건을 충족하는 CSI Trident 인스턴스가 있는 경우 Trident 운영자의 최신 릴리즈로 업그레이드할 수 있습니다.

단계

최신 Astra Trident 릴리스를 다운로드하십시오.

# Download the release required [22.10.0]
mkdir 22.10.0
cd 22.10.0
wget https://github.com/NetApp/trident/releases/download/v22.10.0/trident-installer-22.10.0.tar.gz
tar -xf trident-installer-22.10.0.tar.gz
cd trident-installer

를 생성합니다 tridentorchestrator 매니페스트에서 CRD를 선택합니다.

kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml

연산자를 전개합니다.

#Install the cluster-scoped operator in the **same namespace**
kubectl create -f deploy/<BUNDLE.YAML>
serviceaccount/trident-operator created
clusterrole.rbac.authorization.k8s.io/trident-operator created
clusterrolebinding.rbac.authorization.k8s.io/trident-operator created
deployment.apps/trident-operator created
podsecuritypolicy.policy/tridentoperatorpods created

#Examine the pods in the Trident namespace
NAME                                READY   STATUS    RESTARTS   AGE
trident-csi-79df798bdc-m79dc        6/6     Running   0          150d
trident-csi-xrst8                   2/2     Running   0          150d
trident-operator-5574dbbc68-nthjv   1/1     Running   0          1m30s

을 생성합니다 TridentOrchestrator Astra Trident 설치용 CR.

#Create a tridentOrchestrator to initate a Trident install
cat deploy/crds/tridentorchestrator_cr.yaml
apiVersion: trident.netapp.io/v1
kind: TridentOrchestrator
metadata:
  name: trident
spec:
  debug: true
  namespace: trident

kubectl create -f deploy/crds/tridentorchestrator_cr.yaml

#Examine the pods in the Trident namespace
NAME                                READY   STATUS    RESTARTS   AGE
trident-csi-79df798bdc-m79dc        6/6     Running   0          1m
trident-csi-xrst8                   2/2     Running   0          1m
trident-operator-5574dbbc68-nthjv   1/1     Running   0          5m41s

#Confirm Trident was upgraded to the desired version
kubectl describe torc trident | grep Message -A 3
Message:                Trident installed
Namespace:              trident
Status:                 Installed
Version:                v22.10.0

기존 백엔드 및 PVC는 자동으로 사용할 수 있습니다.

운영자와 함께 업그레이드하십시오

Creating your file...

클러스터 범위 운영자 설치를 업그레이드하십시오

네임스페이스 범위 연산자 설치를 업그레이드합니다

제어 기반 작업자 설치를 업그레이드합니다

비운영자 설치에서 업그레이드