デプロイ スクリプトを使用してハイブリッド マシンを Azure に接続する

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

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

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

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

SQL Server の自動接続

Microsoft SQL Server がインストールされた Windows または Linux サーバーを Azure Arc に接続すると、SQL Server インスタンスも自動的に Azure Arc に登録されます。 Azure Arc によって有効化された SQL Server には、SQL Server インスタンスとデータベース用の詳細インベントリと追加の管理機能が備わっています。 接続プロセスの一環として、拡張機能が Azure Arc 対応サーバーにデプロイされ、SQL Server およびデータベースに新しいロールが自動的に適用されます。 SQL Server を Azure Arc に自動的に接続したくない場合は、Azure Arc への接続時に、名前が ArcSQLServerExtensionDeployment、値が Disabled のタグを Windows または Linux サーバーに追加することでオプトアウトできます。

詳細については、「Azure Arc によって有効化された SQL Server の自動接続を管理する」を参照してください。

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

Azure portal を使用して、エージェントのダウンロードとインストールを自動化し、Azure Arc との接続を確立するスクリプトを作成します。そのプロセスを完了するには、次の手順を実行します。

1. ブラウザーから Azure portal にサインインします。

2. Azure Arc 上 |[マシン] ページで、[追加/作成] を選択し、ドロップダウン メニューから [マシンの追加] を選択します。

3. [ Azure Arc を使用したサーバーの追加 ] ページの [ 単一サーバーの追加] タイルで、[ スクリプトの生成] を選択します。

4. [基本] ページで、以下を設定します。

   1. [ プロジェクトの詳細 ] セクションで、マシンを管理する サブスクリプション と リソース グループ を選択します。
   2. [ サーバーの詳細 ] セクションで、サーバーメタデータを格納する リージョン を選択します。
   3. [オペレーティング システム] ドロップダウン リストで、スクリプトを実行するように構成されているオペレーティング システムを選択します。
   4. 接続方法の場合:
      1. [パブリック エンドポイント] または [プライベート エンドポイント] を選択します。 [プライベート エンドポイント] を選択した場合は、既存のプライベート リンク スコープを選択するか、新しいプライベート リンク スコープを作成できます。
      2. プロキシ サーバー URL を使用する場合は、プロキシ サーバーの IP アドレス、またはコンピューターが使用する名前とポート番号をhttp://<proxyURL>:<proxyport>形式で入力します。
      3. [パブリック エンドポイント] を選択し、Azure Arc Gateway を使用する場合は、既存のゲートウェイ リソースを選択するか、新しいリソースを作成します。
   5. [次へ] を選択して、[タグ] ページに移動します。

5. [タグ] ページで、提案されている既定の物理的な場所のタグを確認し、値を入力するか、カスタム タグを 1 つ以上指定して標準をサポートします。

6. [ 次へ ] を選択して、[スクリプトのダウンロードと実行] ページに移動します。

7. [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
   

   Note

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

   詳細については、「エージェント固有のプロキシ構成」をご覧ください。

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

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

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

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

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

   Note

   このスクリプトは、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 Azure 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 AZure 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 に移動して、サーバーが正常に接続されたことを確認します。

次のステップ

• トラブルシューティング情報については、Connected Machine エージェントのトラブルシューティング ガイドに関するページを参照してください。

• 計画と展開ガイドを参照して、任意の規模で Azure Arc 対応サーバーをデプロイし、一元的な管理と監視を実装する計画を立ててください。

• Azure Policy を使用してマシンを管理する方法を確認します。VM のゲスト構成、予期された Log Analytics ワークスペースがマシンの報告先であることの確認、VM 分析情報を使用した監視の有効化などの方法です。