Java を使用して Azure で Windows VM を作成および管理する

適用対象: ✔️ Windows VM

Azure 仮想マシン (VM) には、いくつかのサポート Azure リソースが必要です。 この記事では、Java を使って VM リソースを作成、管理、削除する方法について説明します。 学習内容は次のとおりです。

• Maven プロジェクトを作成する
• 依存関係を追加する
• 資格情報を作成する
• リソースを作成する
• 管理タスクを実行する
• リソースを削除する
• アプリケーションの実行

これらの手順を実行するには約 20 分かかります。

Maven プロジェクトを作成する

1. Java をまだインストールしていない場合はインストールします。

2. Maven をインストールします。

3. 新しいフォルダーとプロジェクトを作成します。

   mkdir java-azure-test
   cd java-azure-test
   
   mvn archetype:generate -DgroupId=com.fabrikam -DartifactId=testAzureApp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
   

依存関係を追加する

1. testAzureApp フォルダーの中の pom.xml ファイルを開き、ビルド構成を <プロジェクト> に追加して、アプリケーションのビルドを有効にします。

   <build>
     <plugins>
       <plugin>
           <groupId>org.codehaus.mojo</groupId>
           <artifactId>exec-maven-plugin</artifactId>
           <configuration>
               <mainClass>com.fabrikam.testAzureApp.App</mainClass>
           </configuration>
       </plugin>
     </plugins>
   </build>
   

2. Azure の Java SDK へのアクセスに必要な依存関係を追加します。

   <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-identity</artifactId>
     <version>1.3.6</version>
   </dependency>
   <dependency>
     <groupId>com.azure.resourcemanager</groupId>
     <artifactId>azure-resourcemanager</artifactId>
     <version>2.8.0</version>
   </dependency>
   

3. ファイルを保存します。

認証の設定

認証を設定する方法について説明します。

管理クライアントを作成する

1. src\main\java\com\fabrikam の中の App.java ファイルを開き、次の package ステートメントが先頭にあることを確認します。

   package com.fabrikam.testAzureApp;
   

2. AzureResourceManager を作成します。

   TokenCredential credential = new EnvironmentCredentialBuilder()
               .authorityHost(AzureAuthorityHosts.AZURE_PUBLIC_CLOUD)
               .build();
   
   // Please finish 'Set up authentication' step first to set the four environment variables: AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID
   AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
   
   AzureResourceManager azureResourceManager = AzureResourceManager.configure()
           .withLogLevel(HttpLogDetailLevel.BASIC)
           .authenticate(credential, profile)
           .withDefaultSubscription();
   

リソースを作成する

リソース グループの作成

すべてのリソースは、リソース グループに含まれる必要があります。

アプリケーションに値を指定し、リソース グループを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating resource group...");
ResourceGroup resourceGroup = azure.resourceGroups()
    .define("myResourceGroup")
    .withRegion(Region.US_EAST)
    .create();

可用性セットを作成する

可用性セットを使うと、アプリケーションで使う仮想マシンの管理が容易になります。

可用性セットを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating availability set...");
AvailabilitySet availabilitySet = azure.availabilitySets()
    .define("myAvailabilitySet")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .create();

パブリック IP アドレスの作成

仮想マシンと通信するには、パブリック IP アドレスが必要です。

仮想マシンのパブリック IP アドレスを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating public IP address...");
PublicIpAddress publicIPAddress = azure.publicIpAddresses()
    .define("myPublicIP")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withDynamicIP()
    .create();

仮想ネットワークの作成

仮想マシンは、仮想ネットワークのサブネット内に存在する必要があります。

サブネットと仮想ネットワークを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating virtual network...");
Network network = azure.networks()
    .define("myVN")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withAddressSpace("10.0.0.0/16")
    .withSubnet("mySubnet", "10.0.0.0/24")
    .create();

ネットワーク インターフェイスの作成

仮想マシンが仮想ネットワーク上で通信するには、ネットワーク インターフェイスが必要です。

ネットワーク インターフェイスを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating network interface...");
NetworkInterface networkInterface = azure.networkInterfaces()
    .define("myNIC")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withExistingPrimaryNetwork(network)
    .withSubnet("mySubnet")
    .withPrimaryPrivateIPAddressDynamic()
    .withExistingPrimaryPublicIPAddress(publicIPAddress)
    .create();

仮想マシンの作成

すべての関連リソースを作成したので、仮想マシンを作成できます。

仮想マシンを作成するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Creating virtual machine...");
VirtualMachine virtualMachine = azure.virtualMachines()
    .define("myVM")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withExistingPrimaryNetworkInterface(networkInterface)
    .withLatestWindowsImage("MicrosoftWindowsServer", "WindowsServer", "2012-R2-Datacenter")
    .withAdminUsername("azureuser")
    .withAdminPassword("Azure12345678")
    .withComputerName("myVM")
    .withExistingAvailabilitySet(availabilitySet)
    .withSize("Standard_DS1")
    .create();
Scanner input = new Scanner(System.in);
System.out.println("Press enter to get information about the VM...");
input.nextLine();

Note

このチュートリアルでは、Windows Server オペレーティング システムのバージョンを実行する仮想マシンを作成します。 他のイメージの選択の詳細については、 Windows PowerShell と Azure CLI による Azure 仮想マシン イメージのナビゲーションと選択に関する記事をご覧ください。

Marketplace イメージではなく、既存のディスクを使用する場合は、このコードを使用します。

Disk managedDisk = azure.disks().define("myosdisk")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withWindowsFromVhd("https://mystorage.blob.core.windows.net/vhds/myosdisk.vhd")
    .withStorageAccountName("mystorage")
    .withSizeInGB(128)
    .withSku(DiskSkuTypes.PREMIUM_LRS)
    .create();

azure.virtualMachines().define("myVM")
    .withRegion(Region.US_EAST)
    .withExistingResourceGroup("myResourceGroup")
    .withExistingPrimaryNetworkInterface(networkInterface)
    .withSpecializedOSDisk(managedDisk, OperatingSystemTypes.WINDOWS)
    .withExistingAvailabilitySet(availabilitySet)
    .withSize(VirtualMachineSizeTypes.STANDARD_DS1)
    .create();

管理タスクを実行する

仮想マシンのライフサイクルで、各種の管理タスクを実行する必要がある場合があります (仮想マシンの起動、停止、削除など)。 また、何度も行う作業や複雑な作業は、コードを作成して自動化したい場合もあるでしょう。

VM で何かを実行する必要がある場合、そのインスタンスを取得する必要があります。 次のコードを main メソッドの try ブロックに追加します。

VirtualMachine vm = azure.virtualMachines().getByResourceGroup("myResourceGroup", "myVM");

VM に関する情報を取得する

仮想マシンに関する情報を取得するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("hardwareProfile");
System.out.println("    vmSize: " + vm.size());
System.out.println("storageProfile");
System.out.println("  imageReference");
System.out.println("    publisher: " + vm.storageProfile().imageReference().publisher());
System.out.println("    offer: " + vm.storageProfile().imageReference().offer());
System.out.println("    sku: " + vm.storageProfile().imageReference().sku());
System.out.println("    version: " + vm.storageProfile().imageReference().version());
System.out.println("  osDisk");
System.out.println("    osType: " + vm.storageProfile().osDisk().osType());
System.out.println("    name: " + vm.storageProfile().osDisk().name());
System.out.println("    createOption: " + vm.storageProfile().osDisk().createOption());
System.out.println("    caching: " + vm.storageProfile().osDisk().caching());
System.out.println("osProfile");
System.out.println("    computerName: " + vm.osProfile().computerName());
System.out.println("    adminUserName: " + vm.osProfile().adminUsername());
System.out.println("    provisionVMAgent: " + vm.osProfile().windowsConfiguration().provisionVMAgent());
System.out.println(
        "    enableAutomaticUpdates: " + vm.osProfile().windowsConfiguration().enableAutomaticUpdates());
System.out.println("networkProfile");
System.out.println("    networkInterface: " + vm.primaryNetworkInterfaceId());
System.out.println("vmAgent");
System.out.println("  vmAgentVersion: " + vm.instanceView().vmAgent().vmAgentVersion());
System.out.println("    statuses");
for (InstanceViewStatus status : vm.instanceView().vmAgent().statuses()) {
    System.out.println("    code: " + status.code());
    System.out.println("    displayStatus: " + status.displayStatus());
    System.out.println("    message: " + status.message());
    System.out.println("    time: " + status.time());
}
System.out.println("disks");
for (DiskInstanceView disk : vm.instanceView().disks()) {
    System.out.println("  name: " + disk.name());
    System.out.println("  statuses");
    for (InstanceViewStatus status : disk.statuses()) {
        System.out.println("    code: " + status.code());
        System.out.println("    displayStatus: " + status.displayStatus());
        System.out.println("    time: " + status.time());
    }
}
System.out.println("VM general status");
System.out.println("  provisioningStatus: " + vm.provisioningState());
System.out.println("  id: " + vm.id());
System.out.println("  name: " + vm.name());
System.out.println("  type: " + vm.type());
System.out.println("VM instance status");
for (InstanceViewStatus status : vm.instanceView().statuses()) {
    System.out.println("  code: " + status.code());
    System.out.println("  displayStatus: " + status.displayStatus());
}
System.out.println("Press enter to continue...");
input.nextLine();

VM を停止する

仮想マシンを停止してそのすべての設定を保持する (引き続き課金されます)、または仮想マシンを停止して割り当てを解除します。 仮想マシンの割り当てを解除すると、それに関連付けられているすべてのリソースの割り当ても解除され、仮想マシンに対する課金が終了します。

仮想マシンの割り当てを解除せずに仮想マシンを停止するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Stopping vm...");
vm.powerOff();
System.out.println("Press enter to continue...");
input.nextLine();

仮想マシンの割り当てを解除する場合は、PowerOff 呼び出しを次のコードに変更します。

vm.deallocate();

VM を起動する

仮想マシンを起動するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Starting vm...");
vm.start();
System.out.println("Press enter to continue...");
input.nextLine();

VM のサイズを変更する

仮想マシンのサイズを決定するときは、デプロイのさまざまな面を考慮する必要があります。 詳しくは、VM サイズをご覧ください。

仮想マシンのサイズを変更するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Resizing vm...");
vm.update()
    .withSize(VirtualMachineSizeTypes.STANDARD_DS2)
    .apply();
System.out.println("Press enter to continue...");
input.nextLine();

VM にデータ ディスクを追加する

仮想マシンにサイズが 2 GB で、LUN が 0 で、キャッシングの種類が ReadWrite のデータ ディスクを追加するには、次のコードを main メソッドの try ブロックに追加します。

System.out.println("Adding data disk...");
vm.update()
    .withNewDataDisk(2, 0, CachingTypes.READ_WRITE)
    .apply();
System.out.println("Press enter to delete resources...");
input.nextLine();

リソースを削除する

Azure で使用されるリソースに対して課金されるため、不要になったリソースは削除することを常にお勧めします。 仮想マシンとすべての関連リソースを削除する場合、必要な操作はリソース グループの削除だけです。

1. リソース グループを削除するには、次のコードを main メソッドの try ブロックに追加します。

   System.out.println("Deleting resources...");
   azure.resourceGroups().deleteByName("myResourceGroup");
   

2. App.java ファイルを保存します。

アプリケーションの実行

このコンソール アプリケーションが実行を開始してから完全に終了するまでには、約 5 分かかります。

1. アプリケーションを実行するには、次の Maven コマンドを使用します。

   mvn compile exec:java
   

2. Enter キーを押してリソースの削除を開始する前に、Azure Portal でリソースの作成状況を確認することもできます。 デプロイに関する情報を参照するには、デプロイ状態をクリックします。

次のステップ

• Azure の Java ライブラリの使用方法について詳しく学習します。