az aks draft

참고 항목

이 참조는 Azure CLI(버전 2.56.0 이상)에 대한 aks-preview 확장의 일부입니다. az aks draft 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

프로젝트 디렉터리에 배포 파일을 빌드하고 AKS 클러스터에 배포하는 명령입니다.

명령

Name	Description	형식	상태
az aks draft create	프로젝트 디렉터리에 대한 Dockerfile 및 필요한 최소 Kubernetes 배포 파일(helm, kustomize, 매니페스트)을 생성합니다.	내선 번호	GA
az aks draft generate-workflow	AKS에 자동 빌드 및 배포를 위한 GitHub 워크플로를 생성합니다.	내선 번호	GA
az aks draft setup-gh	애플리케이션에 대한 GitHub OIDC를 설정합니다.	내선 번호	GA
az aks draft up	GitHub OIDC를 설정하고 AKS에 자동 빌드 및 배포를 위한 GitHub 워크플로를 생성합니다.	내선 번호	GA
az aks draft update	인터넷에 액세스할 수 있도록 애플리케이션을 업데이트합니다.	내선 번호	GA

az aks draft create

프로젝트 디렉터리에 대한 Dockerfile 및 필요한 최소 Kubernetes 배포 파일(helm, kustomize, 매니페스트)을 생성합니다.

az aks draft create [--app]
                    [--create-config]
                    [--deployment-only]
                    [--destination]
                    [--dockerfile-only]
                    [--language]
                    [--path]

예제

현재 디렉터리에 Dockerfile 및 배포 파일을 생성하라는 메시지가 표시됩니다.

az aks draft create

현재 디렉터리에 Dockerfile만 생성합니다.

az aks draft create --dockerfile-only=true

현재 디렉터리에 배포 파일만 생성합니다.

az aks draft create --deployment-only=true

특정 프로젝트 디렉터리에 앱 이름을 사용하여 Java 프로젝트에서 Dockerfile 및 배포 파일을 생성합니다.

az aks draft create --language=java --app=some_app --destination=/projects/some_project

선택적 매개 변수

--app

helm 릴리스의 이름을 지정합니다.

--create-config

구성 파일의 경로를 지정합니다.

--deployment-only

Kubernetes 배포에 대한 배포 파일(helm, kustomize, 매니페스트)만 생성합니다.

--destination

프로젝트 디렉터리의 경로를 지정합니다(기본값은 .).

기본값: .

--dockerfile-only

Kubernetes 배포에 대한 Dockerfile만 생성합니다.

--language

Kubernetes 배포를 만드는 데 사용되는 언어를 지정합니다.

--path

지정된 위치에서 Draft 이진 파일을 자동으로 다운로드하여 사용합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks draft generate-workflow

AKS에 자동 빌드 및 배포를 위한 GitHub 워크플로를 생성합니다.

이 명령을 실행하기 전에 애플리케이션에 대해 GitHub OIDC를 설정했는지 확인합니다. 또한 Azure에서 리소스 그룹, 컨테이너 레지스트리 및 Kubernetes 클러스터를 만들고 다음을 사용하여 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>세 개의 리소스를 연결해야 합니다.

az aks draft generate-workflow [--branch]
                               [--cluster-name]
                               [--container-name]
                               [--destination]
                               [--path]
                               [--registry-name]
                               [--resource-group]

예제

현재 디렉터리에서 GitHub 워크플로를 생성하라는 메시지를 표시합니다.

az aks draft generate-workflow

특정 프로젝트 디렉터리에서 GitHub 워크플로를 생성하라는 메시지를 표시합니다.

az aks draft generate-workflow --destination=/projects/some_project

리소스 그룹, AKS 클러스터 이름, 특정 프로젝트 디렉터리의 컨테이너 레지스트리 이름을 사용하여 GitHub 워크플로를 생성합니다.

az aks draft generate-workflow --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --destination=/projects/some_project

리소스 그룹, AKS 클러스터 이름, 컨테이너 레지스트리 이름 및 특정 프로젝트 디렉터리의 컨테이너 이미지 이름을 사용하여 기본 분기에서 배포하는 GitHub 워크플로를 생성합니다.

az aks draft generate-workflow --branch=main --resource-group=some_rg --cluster-name=some_cluster --registry-name=some_registry --container-name=some_image --destination=/projects/some_project

선택적 매개 변수

--branch

자동으로 배포할 GitHub 분기를 지정합니다.

--cluster-name

AKS 클러스터 이름을 지정합니다.

--container-name

컨테이너 이미지의 이름을 지정합니다.

--destination

프로젝트 디렉터리의 경로를 지정합니다(기본값은 .).

--path

지정된 위치에서 Draft 이진 파일을 자동으로 다운로드하여 사용합니다.

--registry-name

프로젝트 디렉터리의 경로를 지정합니다.

--resource-group

Azure 리소스 그룹의 이름을 지정합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks draft setup-gh

애플리케이션에 대한 GitHub OIDC를 설정합니다.

az aks draft setup-gh [--app]
                      [--gh-repo]
                      [--path]
                      [--provider]
                      [--resource-group]
                      [--subscription-id]

예제

리포지토리에 대한 GitHub OIDC를 설정하라는 메시지가 표시됩니다.

az aks draft setup-gh

특정 리포지토리에 대해 Azure에서 GitHub OIDC를 설정합니다.

az aks draft setup-gh --provider=azure --gh-repo=some_organization/some_repo

구독 ID 및 리소스 그룹을 사용하여 Azure에서 GitHub OIDC를 설치합니다.

az aks draft setup-gh --provider=azure --subscription-id=some_subscription --resource-group=some_rg

특정 리포지토리에 대한 구독 ID 및 리소스 그룹을 사용하여 Azure에서 애플리케이션 이름으로 GitHub OIDC를 설정합니다.

az aks draft setup-gh --app=some_app --provider=azure --subscription-id=some_subscription --resource-group=some_rg --gh-repo=some_organization/some_repo

선택적 매개 변수

--app

Azure Active Directory 해당 이름을 지정합니다.

--gh-repo

GitHub 리포지토리(조직/repo_name)를 지정합니다.

--path

지정된 위치에서 Draft 이진 파일을 자동으로 다운로드하여 사용합니다.

--provider

클라우드 공급자를 지정합니다(기본값은 azure).

기본값: azure

--resource-group

Azure 리소스 그룹의 이름을 지정합니다.

--subscription-id

Azure 구독 ID를 지정합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks draft up

GitHub OIDC를 설정하고 AKS에 자동 빌드 및 배포를 위한 GitHub 워크플로를 생성합니다.

이 명령은 결합 및 az aks draft generate-workflow.az aks draft setup-gh 이 명령을 실행하기 전에 Azure에서 리소스 그룹, 컨테이너 레지스트리 및 Kubernetes 클러스터를 만들고 다음을 사용하여 az aks update -n <cluster-name> -g <resource-group-name> --attach-acr <acr-name>세 개의 리소스를 연결합니다.

az aks draft up [--app]
                [--branch]
                [--cluster-name]
                [--container-name]
                [--destination]
                [--gh-repo]
                [--path]
                [--provider]
                [--registry-name]
                [--resource-group]
                [--subscription-id]

예제

GitHub OIDC를 설치하라는 메시지가 표시되면 현재 디렉터리에 GitHub 워크플로를 생성합니다.

az aks draft up

GitHub OIDC를 설치하라는 메시지가 표시되면 특정 프로젝트 디렉터리에서 GitHub 워크플로를 생성합니다.

az aks draft up --destination=/projects/some_project

특정 리포지토리에 대해 GitHub OIDC를 설정하라는 메시지가 표시되면 특정 프로젝트 디렉터리에 GitHub 워크플로를 생성합니다.

az aks draft up --gh-repo=some_organization/some_repo --destination=/projects/some_project

선택적 매개 변수

--app

애플리케이션의 이름을 지정합니다.

--branch

자동으로 배포할 GitHub 분기를 지정합니다.

--cluster-name

AKS 클러스터 이름을 지정합니다.

--container-name

컨테이너 이미지의 이름을 지정합니다.

--destination

프로젝트 디렉터리의 경로를 지정합니다(기본값은 .).

--gh-repo

GitHub 리포지토리(조직/repo_name)를 지정합니다.

--path

지정된 위치에서 Draft 이진 파일을 자동으로 다운로드하여 사용합니다.

--provider

클라우드 공급자를 지정합니다(기본값은 azure).

기본값: azure

--registry-name

프로젝트 디렉터리의 경로를 지정합니다.

--resource-group

Azure 리소스 그룹의 이름을 지정합니다.

--subscription-id

Azure 구독 ID를 지정합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az aks draft update

인터넷에 액세스할 수 있도록 애플리케이션을 업데이트합니다.

이 명령은 애플리케이션이 외부 요청을 받을 수 있도록 필요에 따라 yaml 파일을 자동으로 업데이트합니다.

az aks draft update [--certificate]
                    [--destination]
                    [--host]
                    [--path]

예제

인터넷에 액세스할 수 있도록 애플리케이션을 업데이트하라는 메시지를 표시합니다.

az aks draft update

특정 프로젝트 디렉터리에서 인터넷에 액세스할 수 있도록 애플리케이션을 업데이트하라는 메시지가 표시됩니다.

az aks draft update --destination=/projects/some_project

특정 프로젝트 디렉터리에서 수신 리소스의 호스트 및 Keyvault 인증서를 사용하여 인터넷에 액세스할 수 있도록 애플리케이션을 업데이트합니다.

az aks draft update --host=some_host --certificate=some_certificate --destination=/projects/some_project

선택적 매개 변수

--certificate

표시할 Keyvault 인증서의 URI를 지정합니다.

--destination

프로젝트 디렉터리의 경로를 지정합니다(기본값은 .).

--host

수신 리소스의 호스트를 지정합니다.

--path

지정된 위치에서 Draft 이진 파일을 자동으로 다운로드하여 사용합니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.