Azure Stack 허브에 Azure CLI 설치Install Azure CLI on Azure Stack Hub

Azure CLI를 설치 하 여 Windows 또는 Linux 컴퓨터에서 Azure Stack 허브를 관리할 수 있습니다.You can install the Azure CLI to manage Azure Stack Hub with a Windows or Linux machines. 이 문서에서는 Azure CLI를 설치 하 고 설정 하는 단계를 안내 합니다.This article walks you through the steps of installing and setting up Azure CLI.

Azure CLI 설치Install Azure CLI

  1. 개발 워크스테이션에 로그인 하 여 CLI를 설치 합니다.Sign in to your development workstation and install CLI. Azure Stack 허브에는 Azure CLI 버전 2.0 이상이 필요 합니다.Azure Stack Hub requires version 2.0 or later of Azure CLI.

  2. Azure CLI 설치 문서에 설명 된 단계를 사용 하 여 CLI를 설치할 수 있습니다.You can install the CLI by using the steps described in the Install the Azure CLI article.

  3. 설치가 성공적으로 수행 되었는지 여부를 확인 하려면 터미널 또는 명령 프롬프트 창을 열고 다음 명령을 실행 합니다.To verify whether the installation was successful, open a terminal or command prompt window and run the following command:

    az --version
    

    컴퓨터에 설치 된 Azure CLI 및 기타 종속 라이브러리의 버전이 표시 되어야 합니다.You should see the version of Azure CLI and other dependent libraries that are installed on your computer.

    Azure Stack 허브 Python 위치의 Azure CLI

  4. CLI의 Python 위치를 기록해 둡니다.Make a note of the CLI's Python location. ASDK를 실행 하는 경우이 위치를 사용 하 여 인증서를 추가 해야 합니다.If you're running the ASDK, you need to use this location to add your certificate. ASDK CLI 설치를 위한 인증서 설정에 대 한 지침은 Azure Stack Development Kit에서 Azure CLI에 대 한 인증서 설정을 참조 하세요.For instructions on setting up certificates for installing the CLI on the ASDK, see Setting up certificates for Azure CLI on Azure Stack Development Kit.

Azure CLI 연결Connect with Azure CLI

이 섹션에서는 id 관리 서비스로 Azure AD를 사용 하 고 Windows 컴퓨터에서 CLI를 사용 하는 경우 CLI를 설정 하는 과정을 안내 합니다.This section walks you through setting up CLI if you're using Azure AD as your identity management service, and are using CLI on a Windows machine.

Azure Stack 허브에 연결Connect to Azure Stack Hub

  1. ASDK를 사용 하는 경우 Azure Stack 허브 CA 루트 인증서를 신뢰 합니다.If you are using the ASDK, trust the Azure Stack Hub CA root certificate. 지침은 인증서 신뢰를 참조 하세요.For instruction, see Trust the certificate.

  2. 명령을 실행 하 여 Azure Stack 허브 환경을 등록 az cloud register 합니다.Register your Azure Stack Hub environment by running the az cloud register command.

  3. 환경을 등록합니다.Register your environment. 을 실행 하는 경우 다음 매개 변수를 사용 합니다 az cloud register .Use the following parameters when running az cloud register:

    Value 예제Example DescriptionDescription
    환경 이름Environment name AzureStackUserAzureStackUser AzureStackUser사용자 환경에 사용 합니다.Use AzureStackUser for the user environment. 연산자 인 경우을 지정 AzureStackAdmin 합니다.If you're operator, specify AzureStackAdmin.
    Resource Manager 엔드포인트Resource Manager endpoint https://management.contoso.onmicrosoft.com ASDK ResourceManagerUrl : https://management.local.azurestack.external/ 통합 시스템의 ResourceManagerUrl 는 통합 https://management.<region>.<fqdn>/ 시스템 끝점에 대 한 질문이 있는 경우 클라우드 운영자에 게 문의 하세요.The ResourceManagerUrl in the ASDK is: https://management.local.azurestack.external/ The ResourceManagerUrl in integrated systems is: https://management.<region>.<fqdn>/ If you have a question about the integrated system endpoint, contact your cloud operator.
    스토리지 엔드포인트Storage endpoint local.contoso.onmicrosoft.comlocal.contoso.onmicrosoft.com local.azurestack.external 는 ASDK에 대 한입니다.local.azurestack.external is for the ASDK. 통합 시스템의 경우 시스템의 끝점을 사용 합니다.For an integrated system, use an endpoint for your system.
    Keyvault 접미사Keyvault suffix . vault.contoso.onmicrosoft.com.vault.contoso.onmicrosoft.com .vault.local.azurestack.external 는 ASDK에 대 한입니다..vault.local.azurestack.external is for the ASDK. 통합 시스템의 경우 시스템의 끝점을 사용 합니다.For an integrated system, use an endpoint for your system.
    끝점 active directory graph 리소스 IDEndpoint active directory graph resource ID https://graph.windows.net/ Active Directory 리소스 ID입니다.The Active Directory resource ID.
    az cloud register `
        -n <environmentname> `
        --endpoint-resource-manager "https://management.<region>.<fqdn>" `
        --suffix-storage-endpoint "<fqdn>" `
        --suffix-keyvault-dns ".vault.<fqdn>" `
        --endpoint-active-directory-graph-resource-id "https://graph.windows.net/"
    

    Azure CLI 참조 설명서에서 register 명령 에 대 한 참조를 찾을 수 있습니다.You can find a reference for the register command in the Azure CLI reference documentation.

  4. 다음 명령을 사용 하 여 활성 환경을 설정 합니다.Set the active environment by using the following commands.

    az cloud set -n <environmentname>
    
  5. Azure Stack 허브 특정 API 버전 프로필을 사용 하도록 환경 구성을 업데이트 합니다.Update your environment configuration to use the Azure Stack Hub specific API version profile. 구성을 업데이트 하려면 다음 명령을 실행 합니다.To update the configuration, run the following command:

    az cloud update --profile 2019-03-01-hybrid
    
  6. 명령을 사용 하 여 Azure Stack 허브 환경에 로그인 az login 합니다.Sign in to your Azure Stack Hub environment by using the az login command.

    사용자 자격 증명을 사용 하거나 클라우드 운영자가 제공한 SPN ( 서비스 주체 )을 사용 하 여 Azure Stack 허브 환경에 로그인 할 수 있습니다.You can sign in to the Azure Stack Hub environment using your user credentials, or with a service principal (SPN) provided to you by your cloud operator.

    • 사용자 로 로그인:Sign in as a user:

      az login 명령 내에 직접 사용자 이름과 암호를 지정하거나 브라우저를 사용하여 인증할 수 있습니다.You can either specify the username and password directly within the az login command, or authenticate by using a browser. 계정에 multi-factor authentication을 사용 하도록 설정한 경우에는 후자를 사용 해야 합니다.You must do the latter if your account has multi-factor authentication enabled:

      az login -u "user@contoso.onmicrosoft.com" -p 'Password123!' --tenant contoso.onmicrosoft.com
      

      참고

      사용자 계정에 multi-factor authentication을 사용 하는 경우 az login 매개 변수를 제공 하지 않고 명령을 사용 합니다 -u .If your user account has multi-factor authentication enabled, use the az login command without providing the -u parameter. 이 명령을 실행 하면 인증을 위해 사용 해야 하는 URL 및 코드가 제공 됩니다.Running this command gives you a URL and a code that you must use to authenticate.

    • 서비스 주체로 로그인 합니다.Sign in as a service principal:

      로그인 하기 전에 Azure Portal 또는 CLI를 통해 서비스 주체를 만들고 역할을 할당 합니다.Before you sign in, create a service principal through the Azure portal or CLI and assign it a role. 이제 다음 명령을 사용 하 여 로그인 합니다.Now, sign in by using the following command:

      az login `
        --tenant <Azure Active Directory Tenant name. `
                  For example: myazurestack.onmicrosoft.com> `
      --service-principal `
        -u <Application Id of the Service Principal> `
        -p <Key generated for the Service Principal>
      
  7. 환경이 올바르게 설정 되어 있고 환경이 활성 클라우드 인지 확인 합니다.Verify that your environment is set correctly and that your environment is the active cloud.

        az cloud list --output table
    

환경이 나열 되 고 IsActive 이 인 것을 확인할 수 있습니다 true .You should see that your environment is listed and IsActive is true. 예를 들면 다음과 같습니다.For example:

IsActive    Name               Profile
----------  -----------------  -----------------
False       AzureCloud         2019-03-01-hybrid
False       AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest
True        AzureStackUser     2019-03-01-hybrid

연결 테스트Test the connectivity

모든 설정이 설정 된 상태에서 CLI를 사용 하 여 Azure Stack 허브 내에 리소스를 만듭니다.With everything set up, use CLI to create resources within Azure Stack Hub. 예를 들어 앱에 대 한 리소스 그룹을 만들고 VM을 추가할 수 있습니다.For example, you can create a resource group for an app and add a VM. 다음 명령을 사용 하 여 "MyResourceGroup" 이라는 리소스 그룹을 만듭니다.Use the following command to create a resource group named "MyResourceGroup":

az group create -n MyResourceGroup -l local

리소스 그룹이 성공적으로 만들어지면 이전 명령은 새로 만든 리소스의 다음 속성을 출력 합니다.If the resource group is created successfully, the previous command outputs the following properties of the newly created resource:

리소스 그룹 만들기 출력

다음 단계Next steps