Azure portal からハイブリッド マシンを Azure に接続する

手動で一連の手順を実行することで、環境内の 1 つまたは少数の Windows マシンまたは Linux マシン用に、Azure Arc 対応サーバーを有効にすることができます。 または、提供されているテンプレート スクリプトを実行することで、自動化された方法を使用することもできます。 このスクリプトは、両方のエージェントのダウンロードとインストールを自動化するものです。

この方法では、エージェントをインストールおよび構成するために、マシンに対する管理者権限が必要です。 Linux ではルート アカウントを使用し、Windows ではローカルの Administrators グループのメンバーである必要があります。

開始する前に、必ず前提条件を確認し、ご利用のサブスクリプションおよびリソースが要件を満たしていることを確認してください。 サポートされているリージョン、および関連するその他の考慮事項については、 サポート対象の Azure リージョン に関する記事を参照してください。

Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。

Azure portal からインストール スクリプトを生成する

ダウンロードとインストールを自動化し、Azure Arc との接続を確立するスクリプトは、Azure portal から入手できます。 そのプロセスを完了するには、次の手順を実行します。

  1. お使いのブラウザーで Azure portal に移動します。

  2. [サーバー - Azure Arc] ページで、左上の [追加] を選択します。

  3. [メソッドを選択してください] ページで、 [Add servers using interactive script](対話型スクリプトを使用してサーバーを追加する) タイルを選択し、 [スクリプトの生成] を選択します。

  4. [スクリプトの生成] ページで、Azure 内でマシンを管理するサブスクリプションとリソース グループを選択します。 マシンのメタデータが格納される Azure の場所を選択します。 この場所は、リソース グループの場所と同じ場合も異なる場合もあります。

  5. [Prerequisites](前提条件) ページで情報を確認し、 [次: リソースの詳細] を選択します。

  6. [リソースの詳細] ページで、以下を設定します。

    1. [リソース グループ] ドロップダウンの一覧で、マシンを管理するリソース グループを選択します。
    2. [リージョン] ドロップダウンの一覧で、サーバーのメタデータを格納する Azure リージョンを選択します。
    3. [オペレーティング システム] ドロップダウン リストで、スクリプトを実行するように構成されているオペレーティング システムを選択します。
    4. マシンがプロキシ サーバー経由でインターネットに接続して通信を行っている場合は、プロキシ サーバーの IP アドレス、またはマシンでプロキシ サーバーとの通信に使用されている名前とポート番号を指定します。 http://<proxyURL>:<proxyport> の形式で値を入力します。
    5. タグ を選択します。
  7. [タグ] ページで、提案されている既定の 物理的な場所のタグ を確認し、値を入力するか、カスタム タグ を 1 つ以上指定して標準をサポートします。

  8. [Next:Download and run script](次: スクリプトをダウンロードして実行する) を選択します。

  9. [Download and run script](次: スクリプトをダウンロードして実行する) ページで概要情報を確認し、 [ダウンロード] を選択します。 引き続き変更が必要な場合は、 [前へ] を選択します。

Windows でエージェントをインストールして検証する

手動でインストールする

Windows インストーラー パッケージ AzureConnectedMachineAgent.msi を実行することで、Connected Machine エージェントを手動でインストールできます。 最新バージョンの Windows エージェント Windows インストーラー パッケージを Microsoft ダウンロード センターからダウンロードできます。

注意

  • エージェントをインストールまたはアンインストールするには、"管理者" アクセス許可が必要です。
  • まず、インストーラー パッケージをダウンロードし、ターゲット サーバー上のフォルダーにコピーするか、共有ネットワーク フォルダーからコピーする必要があります。 オプションを指定せずにこのインストーラー パッケージを実行すると、セットアップ ウィザードが起動します。ここで、指示に従って対話形式でエージェントをインストールできます。

マシンがプロキシ サーバーを介してサービスと通信する必要がある場合は、エージェントをインストールした後、以下の手順で説明するコマンドを実行する必要があります。 このコマンドにより、プロキシ サーバーのシステム環境変数 https_proxy が設定されます。 この構成を利用して、エージェントは HTTP プロトコルを使用してプロキシ サーバー経由で通信します。

Windows インストーラー パッケージのコマンドライン オプションに詳しくない場合は、Msiexec の標準コマンドライン オプションMsiexec のコマンドライン オプションに関するページを参照してください。

たとえば、ヘルプとクイック リファレンスのオプションを確認するには、/? パラメーターを指定してインストール プログラムを実行します。

msiexec.exe /i AzureConnectedMachineAgent.msi /?
  1. エージェントをサイレント モードでインストールし、存在する C:\Support\Logs フォルダー内にセットアップ ログ ファイルを作成するには、次のコマンドを実行します。

    msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"
    

    セットアップの完了後にエージェントが起動しない場合は、詳細なエラー情報のログを確認します。 ログ ディレクトリは %ProgramData%\AzureConnectedMachineAgent\log です。

  2. マシンがプロキシ サーバー経由で通信する必要がある場合は、プロキシ サーバー環境変数を設定するために、次のコマンドを実行します。

    [Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
    $env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
    # For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
    Restart-Service -Name himds
    

    注意

    エージェントでプロキシ認証の設定はサポートされていません。

  3. エージェントをインストールしたら、次のコマンドを実行して、Azure Arc サービスと通信するようにエージェントを構成する必要があります。

    "%ProgramFiles%\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID"
    

スクリプト化された手法を使用してインストールする

  1. サーバーにログインします。

  2. 管理者特権の PowerShell コマンド プロンプトを開きます。

    注意

    このスクリプトは、64 ビット版の Windows PowerShell からの実行のみをサポートしています。

  3. スクリプトをコピーしたフォルダーまたは共有に移動し、./OnboardingScript.ps1 スクリプトを実行することでそのスクリプトをサーバー上で実行します。

セットアップの完了後にエージェントが起動しない場合は、詳細なエラー情報のログを確認します。 ログ ディレクトリは %ProgramData%\AzureConnectedMachineAgent\log です。

Linux でエージェントをインストールして検証する

Linux 用の Connected Machine エージェントは、Microsoft パッケージ リポジトリでホストされたディストリビューション (.RPM または .DEB) に適したパッケージ形式で提供されます。 このシェル スクリプト バンドル Install_linux_azcmagent.sh により、次のアクションが実行されます。

  • packages.microsoft.com からエージェント パッケージをダウンロードするようにホスト マシンを構成します。

  • ハイブリッド リソース プロバイダー パッケージをインストールします。

必要に応じて、--proxy "{proxy-url}:{proxy-port}" パラメーターを含めることで、プロキシ情報を使用してエージェントを構成できます。 この構成を利用して、エージェントは HTTP プロトコルを使用してプロキシ サーバー経由で通信します。

このスクリプトには、サポートされているディストリビューションとサポートされていないディストリビューションを識別するロジックも含まれており、インストールの実行に必要なアクセス許可が検証されます。

次の例では、エージェントをダウンロードしてインストールします。

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the connected machine agent.
bash ~/Install_linux_azcmagent.sh
  1. エージェントをダウンロードしてインストールするには、次のコマンドを実行します。 自分のマシンがインターネットに接続するためにプロキシ サーバー経由で通信する必要がある場合は、--proxy パラメーターを含めます。

    # Download the installation package.
    wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh
    
    # Install the connected machine agent.
    bash ~/Install_linux_azcmagent.sh --proxy "{proxy-url}:{proxy-port}"
    
  2. エージェントをインストールしたら、次のコマンドを実行して、Azure Arc サービスと通信するようにエージェントを構成する必要があります。

    azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --cloud "cloudName"
    if [ $? = 0 ]; then echo "\033[33mTo view your onboarded server(s), navigate to https://portal.azure.com/#blade/HubsExtension/BrowseResource/resourceType/Microsoft.HybridCompute%2Fmachines\033[m"; fi
    

スクリプト化された手法を使用してインストールする

  1. ルート アクセス権を持つアカウントを使用してサーバーにログインします。

  2. スクリプトをコピーしたフォルダーまたは共有に移動し、./OnboardingScript.sh スクリプトを実行することでそのスクリプトをサーバー上で実行します。

セットアップの完了後にエージェントが起動しない場合は、詳細なエラー情報のログを確認します。 ログ ディレクトリは、var/opt/azcmagent/log です。

Azure Arc との接続を検証する

エージェントをインストールし、それを Azure Arc 対応サーバーに接続するように構成したら、Azure portal に移動して、サーバーが正常に接続されたことを確認します。 自分のマシンは Azure portal に表示されます。

成功したサーバー接続

次のステップ