이 문서에서는 Astro CLI를 설치, 업그레이드, 제거하는 모든 방법을 설명합니다. Astro CLI를 설치하여 로컬에서 Airflow를 실행하거나 터미널에서 Astro를 관리해보세요.
로컬 머신에 Astro CLI를 설치할 수 없는 경우에도 Github Actions을 사용하여 Astro CLI 명령을 실행하고 Astro에 배포할 수 있습니다.
Astro CLI 설치
Mac
단 하나의 명령어로 Mac OS에 Astro CLI를 설치할 수 있습니다.
조건
- Homebrew
- Docker Desktop (v18.09 이상)이나 Podman과 같은 컨테이너 서비스
기본적으로 Astro CLI는 로컬에서 Airflow를 실행하기 위한 컨테이너 관리 엔진으로 Docker를 사용합니다. 그러나 조직에서 Podman을 사용하여 컨테이너를 실행하고 관리하는 경우 Astro CLI를 대신 사용하도록 구성할 수 있습니다. 필수 조건 및 구성 단계는 Podman으로 Astro CLI 실행을 참조하세요.
설치
Astro CLI의 최신 버전을 설치하려면 다음 명령을 실행하세요.
brew install astro
Astro CLI의 특정 버전을 설치하려면 명령 끝에 설치하려는 버전을 지정합니다. 예를 들어 Astro CLI 버전 1.31.0을 설치하려면 다음 명령을 실행합니다.
brew install astro@1.31.0
주요 버전만 지정하는 경우 이 명령은 주요 버전에 사용 가능한 최신 마이너 또는 패치 버전을 설치합니다. 사용 가능한 모든 버전 목록은 CLI 릴리스 노트를 참조하세요 .
설치 확인
올바른 Astro CLI 버전이 설치되었는지 확인하려면 다음을 실행하세요.
astro version
설치에서 문제가 발생했을 때
Homebrew가 최신 Astro CLI 버전을 설치하지 못하거나 오류가 No formulae or casks found for astro@<major.minor.patch-version> 나타나면 이 절차를 따르세요. 다른 Homebrew 문제를 해결하려면 Homebrew 설명서의 Common Issues를 참조하세요.
- 설치 과정이 작동하지 않으면 다음 명령을 실행하여 Homebrew와 모든 패키지 정의(formulae)를 업데이트하세요.
brew update
- 설치를 다시 실행하세요.
brew install astro
- 처음으로 CLI를 설치하고 Homebrew 업데이트가 작동하지 않는 경우 Homebrew 탭 목록에
astronomer/tap이 있는지 확인하세요 .
brew tap astronomer/tap
astronomer/tap이 탭 목록에 있는데도 여전히 Astro CLI를 설치할 수 없다면 다른 문제가 있을 수 있습니다. Homebrew 설명서에서 Common Issues를 참조하세요.
- 다음 명령을 실행하여 Astronomer CLI를 설치하세요.
brew install astro
Astro CLI 업그레이드
Astro CLI는 동일한 주요 버전 내의 마이너 버전 간에는 아무런 변경 사항이 없습니다. 따라서 Astronomer는 주요 버전에서 항상 최신 마이너 버전의 Astro CLI를 사용할 것을 권장합니다.
Mac
다음 명령을 실행하여 Astro CLI를 최신 버전으로 업그레이드하세요.
brew upgrade astro
Astro CLI 제거
Mac
Mac에서 Astro CLI를 제거하려면 다음을 실행하세요.
brew uninstall astro