Azure CLI에 대한 환경 준비

아티클
12/06/2023

이 자습서 단계에서는 첫 번째 Azure CLI 명령을 실행합니다. 여기에는 활성 구독 찾기 및 설정 및 기본값 설정이 포함됩니다. 또한 항상 고유한 리소스 이름을 보장하기 위해 임의의 ID를 포함하는 리소스 그룹을 만드는 방법을 알아봅니다.

Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.

이 자습서 단계를 완료하려면 구독에 대한 이상의 권한이 필요합니다 contributor .

Azure CLI 설치

먼저 환경을 선택하여 시작합니다.

각 Azure CLI 코드 블록의 오른쪽 위 모서리에 있는 Cloud Shell 열기 단추를 선택하여 Azure Cloud Shell에서 Bash 환경을 사용합니다.
Azure CLI 참조 명령을 로컬 로 실행하려면 Azure CLI를 설치 합니다.

Azure CLI의 현재 버전은 2.60.0입니다. 최신 릴리스에 대한 자세한 내용은 릴리스 정보를 참조하세요. 설치된 버전을 찾고 업데이트해야 하는지 확인하려면 az 버전을 실행합니다.

Azure CLI를 사용하는 경우 몇 가지 인증 옵션이 있습니다. 로그인에 대한 Azure CLI의 기본 인증 방법은 웹 브라우저 및 액세스 토큰을 사용하여 로그인합니다.

az login 명령을 실행합니다.
```
az login
```
Azure CLI가 기본 브라우저를 열 수 있는 경우 권한 부여 코드 흐름을 시작하고 기본 브라우저를 열어 Azure 로그인 페이지를 로드합니다.

그렇지 않으면 디바이스 코드 흐름을 시작하고 브라우저 페이지를 https://aka.ms/devicelogin열도록 지시합니다. 그런 다음 터미널에 표시되는 코드를 입력합니다.

웹 브라우저를 사용할 수 없거나 웹 브라우저가 열리지 않으면 az login --use-device-code를 사용하여 디바이스 코드 흐름을 적용할 수 있습니다.
브라우저에서 계정 자격 증명으로 로그인합니다.

활성 구독 찾기 및 변경

Azure CLI에 로그인한 후 항상 현재 구독을 검사. 원하는 구독에서 작업하지 않는 경우 az account set를 사용하여 구독을 변경합니다. 사용할 코드 예제는 다음과 같습니다.

# see your current/default subscription
az account show

# find the list of subscriptions available to you
az account list --output table

# change your current/default subscription
az account set --subscription <mySubscriptionName>

# you can also set your subscription using a subscription ID
az account set --subscription <00000000-0000-0000-0000-000000000000>

명령에 대한 az account show 콘솔 출력:

{
  "environmentName": "AzureCloud",
  "homeTenantId": "00000000-0000-0000-0000-000000000000",
  "id": "00000000-0000-0000-0000-000000000000",
  "isDefault": true,
  "managedByTenants": [],
  "name": "Your storage account name",
  "state": "Enabled",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "user": {
    "name": "yourName@contoso.com",
    "type": "user"
  }
}

리소스 그룹에 대해 알아보기

리소스 그룹은 Azure 리소스에 대한 컨테이너입니다. 리소스 그룹을 만들려면 구독에 사용 권한 이상이 필요합니다 contributor .

리소스 그룹 만들기

구독 내에서 리소스 그룹 이름은 고유해야 합니다. az group exists 명령을 사용하여 원하는 이름을 사용할 수 있는지 먼저 검사. 출력 값은 false 이름을 사용할 수 있음을 의미합니다.
```
az group exists --name <myUniqueRGname>
```
az account list-locations 명령을 사용하여 구독에 대해 지원되는 지역 목록을 검색합니다. 사용 가능한 Azure 위치 목록은 적합한 Azure 지역 선택을 참조 하세요.
```
az account list-locations --query "[].{Region:name}" --output table
```
이제 리소스 그룹을 만들겠습니다. az group create 명령을 사용합니다.
```
az group create --location <myLocation> --name <myUniqueRGname>
```

임의 ID를 포함하는 리소스 그룹 만들기

테스트할 때 이름에 임의의 ID가 포함된 리소스 그룹을 만드는 것이 가장 좋습니다. 리소스 그룹 이름에 임의의 ID를 추가하면 동일한 이름의 이전 리소스 그룹이 Azure에서 제거될 때까지 기다리지 않고도 코드를 다시 테스트할 수 있습니다.

Bash 및 PowerShell 변수 구문은 다릅니다. 사용자 환경에 맞는 올바른 스크립트를 복사합니다.

Bash
PowerShell

let "randomIdentifier=$RANDOM*$RANDOM"
location="eastus"
resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

$randomIdentifier = (New-Guid).ToString().Substring(0,8)
$location="eastus"
$resourceGroup="msdocs-tutorial-rg-$randomIdentifier"
az group create --name $resourceGroup --location $location --output json

Bash 및 PowerShell 콘솔 출력:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/msdocs-tutorial-rg-000000000",
  "location": "eastus",
  "managedBy": null,
  "name": "msdocs-tutorial-rg-000000000",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

환경 변수 설정

Azure CLI는 일반적인 매개 변수 값을 다시 사용할 수 있는 몇 가지 옵션을 제공합니다. 이러한 기본값은 환경 변수에 저장되며 로그인할 때마다 고유합니다.

기본 리소스 그룹을 설정합니다.

az config set defaults.group=<msdocs-tutorial-rg-0000000>

한 번에 여러 환경 변수를 설정합니다.

많은 Azure CLI 매개 변수는 공백으로 구분된 여러 값을 사용합니다. 구성 값은 이러한 인스턴스 중 하나입니다. 다음 예제에서는 모든 Azure CLI 명령의 .location 매개 변수 및 .group 매개 변수에서 --location 사용되는 기본값과 --resource-group 기본값을 모두 설정합니다.
```
az config set defaults.location=westus2 defaults.group=<msdocs-tutorial-rg-0000000>
```
기본 출력을 설정합니다.

Azure Cloud Shell에서 작업하거나 Azure CLI를 로컬로 설치하도록 선택하면 기본 출력이 자동으로 로 json설정됩니다. 그러나 이는 이해하고 설정하는 가장 중요한 기본값 중 하나입니다. 출력은 콘솔에 표시되는 내용과 로그 파일에 기록되는 내용을 결정합니다. 키, 암호 및 비밀을 반환하는 리소스를 만들 때 항상 출력 none 을 사용합니다.
```
az config set core.output=none
```
이 자습서에서는 비밀로 작업하지 않습니다. 이 자습서에서 각 참조 명령의 반환된 출력을 볼 수 있도록 기본값을 다시 json 설정합니다.
```
az config set core.output=json
```

를 사용하는 az init방법을 알아봅니다.

Azure CLI에는 환경 구성을 안내하는 참조 명령이 있습니다. 콘솔을 입력 az init 하고 Enter 키를 누릅니 다. 제공된 프롬프트를 따릅니다.

az init

az init에 대한 첫 번째 좋은 점은 현재 설정을 모두 제공한다는 것입니다! 다음은 출력 예제입니다.

Your current config settings:

  Output format: JSON 
  [core.output = json]

  Standard error stream (stderr): All events 
  [core.only_show_errors = false]

  Error output: Show recommendations 
  [core.error_recommendation = on]

  Syntax highlighting: On 
  [core.no_color = false]

  Progress Bar: On 
  [core.disable_progress_bar = false]


Select an option by typing it's number

  [1] Optimize for interaction
      These settings improve the output legibility and optimize for human interaction

  [2] Optimize for automation
      These settings optimize for machine efficiency

  [3] Customize settings
      A walk through to customize common configurations

  [4] Exit (default)
      Return to the command prompt

? Your selection:

구성 파일을 찾아 읽습니다.

"신뢰하지만 확인" 마음가짐으로 작업하는 경우 구성 파일이 저장되는 위치와 포함되는 항목을 알고 싶을 것입니다. 구성 파일 자체는 .에 있습니다 $AZURE_CONFIG_DIR/config. AZURE_CONFIG_DIR의 기본값은 Linux와 macOS의 경우 $HOME/.azure이고 Windows의 경우 %USERPROFILE%\.azure입니다. 이제 구성 파일을 찾아 포함 항목을 확인합니다.

자세한 정보 가져오기

이 자습서 단계에서 다루는 주제 중 하나에 대해 자세히 알아보시겠습니까? 자세한 내용은 이 표의 링크를 사용합니다.

Subject	자세한 정보
환경	적합한 Azure 명령줄 도구 선택
로그인 옵션	Azure CLI로 로그인
사용 약관	Azure CLI 용어 및 지원 수준
Abunələr	Azure CLI를 사용하여 구독 관리
리소스 그룹	Azure CLI를 사용하여 리소스 그룹 관리
구성	Azure CLI 구성
Azure 역할	Azure 역할, Microsoft Entra 역할 및 클래식 구독 관리자 역할

다음 단계

이제 환경을 구성하는 방법을 배웠으므로 다음 단계를 진행하여 Bash, PowerShell 및 Cmd 간의 스크립팅 차이점을 알아봅니다.

Bash, PowerShell 및 Cmd의 Azure CLI 구문 차이점 알아보기