share facebook facebook facebook twitter twitter menu hatena pocket slack

2020.10.26 MON

やさしいAzure CLI のインストール

新川 貴章

WRITTEN BY 新川 貴章

概要

  • Azure 初心者の新川です。今日は、Azure CLI のインストール方法を記載します。Azure CLI は、Azureリソースを作成・管理するためのコマンドラインです。
  • 前提として、今回の目的は、VM,VMSS を管理するための “azコマンド”の準備です。当初、”azコマンド”はAzure power shell のことかな?と思いましたが、どうやら違う。正解はAzure CLIであったことが分かりました。

Azure CLI のインストール

Azure CLIのインストール(for Windows)

  • 下記から、Azure CLI インストーラーをダウンロードします。
Instructions for installing the Azure CLI and learning how to get started.

  • インストーラー(azure-cli-X.XX.X.msi)を実行します。Microsoft Azure CLI Setupの画面にてインストールを進めます。

  • Azure CLI のインストールが完了しました。

  • Windows PowerShell を起動します。”管理者として実行する”を選択すると、azコマンドが認識しません。通常の起動を行います。
PS C:\Users\Administrator> az --version
az : 用語 'az' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。名
前が正しく記述されていることを確認し、パスが含まれている場合はそのパスが正しいことを確認してから、再試行してください。
発生場所 行:1 文字:1
+ az --version
+ ~~
    + CategoryInfo          : ObjectNotFound: (az:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

  • Windows PowerShellが起動後、azコマンドが使えることを確認します。
PS C:\Users\Administrator> az --version
azure-cli                         2.12.1 *

core                              2.12.1 *
telemetry                          1.0.6

Python location 'C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\python.exe'
Extensions directory 'C:\Users\Administrator\.azure\cliextensions'

Python (Windows) 3.6.8 (tags/v3.6.8:3c6b436a57, Dec 23 2018, 23:31:17) [MSC v.1916 32 bit (Intel)]

Legal docs and information: aka.ms/AzureCliLegal


You have 2 updates available. Consider updating your CLI installation with 'az upgrade'

Please let us know how we are doing: https://aka.ms/azureclihats
and let us know if you're interested in trying out our newest features: https://aka.ms/CLIUXstudy
  • az login コマンドを実行します。ブラウザが起動するので、Microsoft アカウントでログインします。
PS C:\Users\Administrator> az login
You have logged in. Now let us find all the subscriptions to which you have access...

  • Microsoft アカウントのログインが成功したら、PowerShellに戻ります。

  • 複数のサブスクリプションがあれば、az account setコマンドで、切り替えたいサブスクリプションIDを指定します。az account showコマンドでサブスクリプションの確認、az logoutで現在のサブスクリプションをクリアします。
PS C:\Users\Administrator> az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
PS C:\Users\Administrator> az account show
{
  "environmentName": "AzureCloud",
  "homeTenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "isDefault": true,
  "managedByTenants": [],
  "name": "testsub-1234",
  "state": "Enabled",
  "tenantId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
  "user": {
    "name": "niikawa@xxxxxxxxxx.jp",
    "type": "user"
  }
}
PS C:\Users\Administrator> az logout

Azure CLIのインストール(for Linux)

  • 手元にログがないため、下記ドキュメントを参照。
How to install the Azure CLI with the apt package manager

azコマンドでValidationErrorが表示された時

症状

  • Azure CLIをインストール後、azコマンドで「ValidationError: Certificate verification failed.」が表示され、azコマンドが使用できないケースがあります。
PS C:\Windows\system32> az login
ValidationError: Certificate verification failed. This typically happens when using Azure CLI behind a proxy that intercepts traffic with a self-signed certificate. Please add this certificate to the trusted CA bundle. More info: https://docs.microsoft.com/en-us/cli/azure/use-cli-effectively#work-behind-a-proxy.

一時的な対処

  • 環境変数に、AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1 を設定して、AzureCLI全体の証明書チェックを無効にします。下記はPowerShell から環境変数を設定する方法ですが、環境変数は一時的であり、保持されません。恒久的に設定する場合は後述します。
  • PowerShellで一時的に対処します。
Windows PowerShell
Copyright (C) 2016 Microsoft Corporation. All rights reserved.

PS C:\Users\Administrator> Set-Location Env:
PS Env:\> [Environment]::SetEnvironmentVariable("AZURE_CLI_DISABLE_CONNECTION_VERIFICATION","1")
PS Env:\> Get-ChildItem AZURE*

Name                           Value
----                           -----
AZURE_CLI_DISABLE_CONNECTIO... 1


PS Env:\>

恒久的な対処

  • 「システムのプロパティ」から「環境変数」を設定することで、恒久的に"AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1″ の環境変数を設定します。

  • PowerShell を再度起動します。("管理者として実行する"は選びませんので、ご注意ください)
  • 下記の通り、"AZURE_CLI_DISABLE_CONNECTION_VERIFICATION=1″が設定されていることを確認します。
Windows PowerShell
Copyright (C) 2016 Microsoft Corporation. All rights reserved.

PS C:\Users\Administrator> Set-Location Env:
PS Env:\> Get-ChildItem AZURE*

Name                           Value
----                           -----
AZURE_CLI_DISABLE_CONNECTIO... 1


PS Env:\>

参考資料

Instructions for installing the Azure CLI and learning how to get started.
Reference for the installation of Azure CLI

元記事はこちら

やさしいAzure CLI のインストール

cloudpack

cloudpackは、Amazon EC2やAmazon S3をはじめとするAWSの各種プロダクトを利用する際の、導入・設計から運用保守を含んだフルマネージドのサービスを提供し、バックアップや24時間365日の監視/障害対応、技術的な問い合わせに対するサポートなどを行っております。
AWS上のインフラ構築およびAWSを活用したシステム開発など、案件のご相談はcloudpack.jpよりご連絡ください。