인스턴스의 패치 버전 관리

이 페이지에서는 Cloud Data Fusion 인스턴스의 패치 버전을 관리하는 방법에 대한 정보와 가이드라인을 제공합니다.

패치 버전과 다른 업그레이드의 차이점에 대한 자세한 내용은 인스턴스 업그레이드와 패치 버전 비교를 참조하세요.

패치 버전에는 인스턴스의 중요한 보안 업데이트와 버그 수정이 포함됩니다. 패치 버전은 파이프라인 또는 플러그인을 변경하지 않고 플랫폼에만 수정사항을 적용합니다. 업그레이드 프로세스에는 인스턴스 및 파이프라인 다운타임이 포함됩니다.

Cloud Data Fusion 버전 관리에 대한 자세한 내용은 Cloud Data Fusion 버전 관리 및 사용 가능한 패치 버전 업그레이드를 참조하세요.

시작하기 전에

패치 버전으로 업그레이드하기 전에 출시 노트에 포함된 특정 수정사항에 대한 정보를 검토하세요. 인스턴스에 미치는 영향을 이해하는 것이 중요합니다.
환경 준비:
- 패치 버전의 다운타임을 예약합니다.
- 권장사항: 업그레이드하기 전에 실행 중인 파이프라인을 중지하고 Cloud Composer 트리거와 같은 업스트림 트리거를 사용 중지하세요. 업그레이드가 시작되면 실행 중인 모든 파이프라인이 중지됩니다.

인스턴스 업그레이드와 패치 버전 비교

인스턴스 업그레이드: 이 버전에는 플랫폼의 최신 기능, 기능 개선, 성능 개선사항이 포함됩니다. 인스턴스 업그레이드는 플러그인 변경사항과 연결되며 파이프라인 업그레이드가 필요합니다. 자세한 내용은 버전 업그레이드: 인스턴스 및 파이프라인을 참조하세요.
패치 버전: 이 버전에는 플랫폼에 대한 중요한 보안 및 버그 수정만 포함되며, 파이프라인과 플러그인 기능을 변경하거나 업데이트하지 않습니다.

Cloud Data Fusion 인스턴스 패치 버전으로 업그레이드

Cloud Data Fusion 인스턴스의 패치 버전으로 업그레이드하려면 Google Cloud 콘솔, Google Cloud CLI, REST API에서 단계를 수행합니다.

콘솔

Google Cloud 콘솔에서 Cloud Data Fusion 페이지로 이동합니다.
인스턴스를 클릭하고 인스턴스 이름 옆의 체크박스를 선택합니다.

인스턴스로 이동
업그레이드를 클릭합니다.
최신 패치 버전을 선택하고 업그레이드를 클릭합니다.
Cloud Data Fusion 웹 인터페이스에서 업그레이드된 인스턴스에 액세스하려면 인스턴스 보기를 클릭합니다.
업그레이드가 성공했는지 확인하려면 Google Cloud 콘솔에서 인스턴스 세부정보 페이지를 새로고침합니다. 업데이트의 버전 필드를 확인합니다.

참고: Cloud Data Fusion 웹 인터페이스의 시스템 관리자 페이지 상단에 표시되는 버전 번호에는 패치 버전 번호가 표시되지 않습니다.

gcloud

사용 가능한 패치 버전으로 업데이트하려면 로컬 터미널 Cloud Shell 세션에서 다음 gcloud CLI 명령어를 실행합니다.
```
gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION
```
다음을 바꿉니다.
- INSTANCE_ID: 인스턴스 이름
- PROJECT_ID: Cloud Data Fusion 인스턴스가 포함된 프로젝트 ID
- LOCATION_NAME: 인스턴스 위치
- CURRENT_INSTANCE_VERSION: 현재의 버전
- AVAILABLE_PATCH_REVISION: 업그레이드할 패치 버전.
- (선택사항) 인스턴스에 해당하는 경우 --enable_stackdriver_logging, --enable_stackdriver_monitoring, --labels 플래그를 추가합니다.
- (선택사항) enable.unrecoverable.reset과 같은 CDAP 속성을 옵션으로 전달할 수 있습니다.
참고: patch_revision 인수 전달은 선택사항입니다. 지정하지 않으면 사용 가능한 최신 패치 버전이 사용됩니다.

자세한 내용은 gcloud CLI 참조를 확인하세요.
다음 단계에 따라 업그레이드가 성공했는지 확인합니다.
1. 로컬 터미널 Cloud Shell 세션에서 다음 gcloud CLI 명령어를 실행하여 인스턴스 세부정보를 가져옵니다.
```
gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID
```
2. 인스턴스 세부정보의 PATCH_REVISION 필드가 지정된 버전으로 업데이트되었는지 확인합니다.

REST API

Cloud Data Fusion 인스턴스의 패치 버전을 수행하려면 patch() 메서드를 호출합니다. 요청에 patchRevision 선택적 필드를 설정합니다. 패치 버전을 지정하지 않으면 사용 가능한 최신 버전이 사용됩니다.

예시

다음 예시에서는 REST API를 사용하여 인스턴스를 패치 버전으로 업그레이드하는 방법을 보여줍니다.

인스턴스를 특정 패치 버전으로 업그레이드

patch() 메서드 호출:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

다음을 바꿉니다.

PROJECT_ID: Cloud Data Fusion 인스턴스가 포함된 프로젝트 ID
LOCATION_NAME: 인스턴스 위치
INSTANCE_ID: 인스턴스 이름

다음 JSON 요청 본문을 사용합니다.

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

다음을 바꿉니다.

VERSION_NUMBER: 인스턴스 버전(예: 6.7.3)
PATCH_REVISION_NUMBER: 업그레이드할 패치 버전(예: 6.7.3.1). 사용 가능한 패치 버전을 참조하세요.

예를 들어 6.7.3 버전 인스턴스를 6.7.3.1 패치 버전으로 업그레이드하려면 다음 JSON 요청 본문을 사용합니다.

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

인스턴스를 기본 패치 버전으로 업그레이드

patch() 메서드 호출:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

다음 JSON 요청 본문을 사용합니다.

{
  "version": VERSION_NUMBER
}

VERSION_NUMBER를 인스턴스 버전(예: 6.7.3)으로 바꿉니다.

{
  "version": 6.7.3
}

패치 버전 롤백

패치 버전을 통합한 후 예기치 않은 문제가 발생하면 다음 단계에 따라 패치 버전을 안정적인 이전 상태로 되돌리세요.

gcloud

이전 패치 버전으로 롤백하려면 로컬 터미널 Cloud Shell 세션에서 다음 gcloud CLI 명령어를 실행합니다.
```
gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION
```
다음을 바꿉니다.
- INSTANCE_ID: 인스턴스 이름
- PROJECT_ID: Cloud Data Fusion 인스턴스가 포함된 프로젝트 ID
- LOCATION_NAME: 인스턴스 위치
- CURRENT_INSTANCE_VERSION: 현재의 버전
- STABLE_PATCH_REVISION: 롤백할 패치 버전.
- (선택사항) 인스턴스에 해당하는 경우 --enable_stackdriver_logging, --enable_stackdriver_monitoring, --labels 플래그를 추가합니다.
- (선택사항) enable.unrecoverable.reset과 같은 CDAP 속성을 옵션으로 전달할 수 있습니다.
자세한 내용은 gcloud CLI 참조를 확인하세요.
다음 단계에 따라 롤백이 성공했는지 확인합니다.
1. 로컬 터미널 Cloud Shell 세션에서 다음 gcloud CLI 명령어를 실행하여 인스턴스 세부정보를 가져옵니다.
```
gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID
```
2. 인스턴스 세부정보의 PATCH_REVISION 필드가 지정된 버전으로 반전되었는지 확인합니다.

REST API

Cloud Data Fusion 인스턴스의 패치 버전을 롤백하려면 patch() 메서드를 호출합니다. 요청의 patchRevision 필드를 안정적인 이전 패치 버전으로 설정합니다.

예

이 예시에서는 REST API를 사용하여 인스턴스를 6.7.3.1 패치 버전에서 6.7.3 패치 버전으로 롤백하는 방법을 보여줍니다.

patch() 메서드 호출:

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

다음을 바꿉니다.

PROJECT_ID: Cloud Data Fusion 인스턴스가 포함된 프로젝트 ID
LOCATION_NAME: 인스턴스 위치
INSTANCE_ID: 인스턴스 이름

다음 JSON 요청 본문을 사용합니다.

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

다음을 바꿉니다.

VERSION_NUMBER: 인스턴스 버전(예: 6.7.3)
STABLE_PATCH_REVISION: 롤백할 패치 버전. 사용 가능한 패치 버전을 참조하세요.

예를 들어 인스턴스를 6.7.3.1 패치 버전에서 6.7.3 패치 버전으로 롤백하려면 다음 JSON 요청 본문을 사용합니다.

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}