기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Apache Airflow 버전 변경
Amazon MWAA는 마이너 버전 업그레이드 및 다운그레이드를 지원합니다. 즉, 환경을 버전 `x.4.z`에서 버전 `x.5.z`로 또는 `x.5.z`에서 `x.4.z`로 업그레이드할 수 있습니다. 예를 들어 버전 `1.y.z`에서 버전 `2.y.z`로 업그레이드하는 메이저 버전 업그레이드를 수행하려면 새 환경을 만들고 리소스를 마이그레이션해야 합니다. Apache Airflow의 새 메이저 버전으로 업그레이드하는 방법에 대한 자세한 내용은 *Amazon MWAA 마이그레이션 가이드*의 [새 Amazon MWAA 환경으로 마이그레이션](https://docs.aws.amazon.com/mwaa/latest/migrationguide/migrating-to-new-mwaa.html)을 참조하세요.
업그레이드 또는 다운그레이드 프로세스 중에 Amazon MWAA는 환경 메타데이터의 스냅샷을 캡처하고 작업자, 스케줄러, 웹 서버를 새 Apache Airflow 버전으로 업그레이드 또는 다운그레이드한 다음 최종적으로 스냅샷을 사용하여 메타데이터 데이터베이스를 복원합니다.
업그레이드 또는 다운그레이드하기 전에 DAG 및 기타 워크플로우 리소스가 업그레이드하려는 새 Apache Airflow 버전과 호환되는지 확인합니다. `requirements.txt`를 사용하여 종속성을 관리하는 경우 요구 사항에 지정한 종속성이 새 버전과 호환되는지도 확인해야 합니다.
**Topics**
+ [워크플로 리소스 업그레이드 또는 다운그레이드](#upgrading-environment-resources)
+ [새 버전 지정](#upgrading-environment-specify-version)
## 워크플로 리소스 업그레이드 또는 다운그레이드
Apache Airflow 버전을 변경할 때마다 `requirements.txt`에서 [올바른 `--constraint` URL을 참조하는지](https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html#working-dags-dependencies-test-create) 확인합니다.
**주의**
업그레이드 또는 다운그레이드 중에 대상 Apache Airflow 버전과 호환되지 않는 요구 사항을 지정하면 이전 요구 사항 버전이 있는 이전 버전의 Apache Airflow로 롤백하는 데 오랜 시간이 걸릴 수 있습니다.
**워크플로 리소스 마이그레이션**
1. [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images) 리포지토리의 포크를 생성하고 Amazon MWAA 로컬 러너의 사본을 복제합니다.
1. 업그레이드 또는 다운그레이드하려는 버전과 일치하는 aws-mwaa-docker-images 리포지토리의 브랜치를 확인합니다.
1. `requirements.txt`을(를) 업데이트하려면 *Amazon MWAA 사용 설명서*의 [Python 종속성 관리](https://docs.aws.amazon.com/mwaa/latest/userguide/best-practices-dependencies.html)에서 권장하는 모범 사례를 따르세요.
1. (선택 사항) 업그레이드 또는 다운그레이드 프로세스의 속도를 높이려면 [환경의 메타데이터 데이터베이스를 정리합니다](samples-database-cleanup.md). 메타데이터 양이 많은 환경은 업그레이드에 상당히 오랜 시간이 걸릴 수 있습니다.
1. 워크플로우 리소스를 성공적으로 테스트한 후 DAG와 `requirements.txt`, 플러그인을 환경의 Amazon S3 버킷으로 복사합니다.
이제 환경을 편집하고, 새 Apache Airflow 버전을 지정하고, 업데이트 절차를 시작할 준비가 되었습니다.
## 새 버전 지정
새 Apache Airflow 버전과의 호환성을 보장하기 위해 워크플로우 리소스를 업데이트한 후, 다음을 수행하여 환경의 세부 정보를 편집하고 업그레이드하려는 Apache Airflow 버전을 지정합니다.
**참고**
업그레이드 또는 다운그레이드를 수행하면 그 과정 동안 환경에서 현재 실행 중인 모든 작업이 종료됩니다. 업데이트 절차에는 최대 2시간이 소요될 수 있으며, 이 기간 동안에는 환경을 사용할 수 없습니다.
**콘솔을 사용하여 새 버전 지정**
1. Amazon MWAA 콘솔에서 [환경 페이지](https://console.aws.amazon.com/mwaa/home#/environments)를 엽니다.
1. **환경** 목록에서 업그레이드 또는 다운그레이드할 환경을 선택합니다.
1. 환경 페이지에서 **편집**을 선택하여 환경을 편집합니다.
1. **환경 세부 정보** 섹션의 **Airflow 버전**에 대해 드롭다운 목록에서 환경을 업그레이드 또는 다운그레이드하려는 Apache Airflow 버전 번호를 선택합니다.
1. **검토 및 저장** 페이지가 표시될 때까지 **다음**을 선택합니다.
1. **검토 및 저장** 페이지에서 변경 사항을 검토한 후 **저장**을 선택합니다.
변경 사항을 적용하면 해당 환경에서 업그레이드 또는 다운그레이드 절차가 시작됩니다. 이 기간 동안 사용자 환경의 [상태](https://docs.aws.amazon.com/mwaa/latest/API/API_Environment.html#mwaa-Type-Environment-Status)는 Amazon MWAA가 취하는 조치와 절차의 성공 여부를 나타냅니다.
업그레이드 또는 다운그레이드가 성공하면 상태가 `UPDATING`이 되고, Amazon MWAA가 메타데이터 백업을 캡처하면 상태가 `CREATING_SNAPSHOT`이 됩니다. 마지막으로 상태가 처음에는 `UPDATING`(으)로 돌아가고, 절차가 완료되면 `AVAILABLE`(으)로 돌아갑니다.
환경 업그레이드 또는 다운그레이드에 실패할 경우 환경 상태가 `ROLLING_BACK`이 됩니다. 롤백이 성공하면 업데이트가 실패했지만 환경을 사용할 수 있음을 나타내는 `UPDATE_FAILED` 상태가 먼저 표시됩니다. 롤백이 실패하면 `UNAVAILABLE` 상태가 되며 환경에 액세스할 수 없음을 나타냅니다.