チュートリアル: Go SDK を使用した Azure パブリック MEC へのリソースのデプロイに関する記事

[アーティクル]
11/22/2022

このチュートリアルでは、Go SDK を使用して、Azure パブリックマルチアクセスエッジコンピューティング (MEC) にリソースをデプロイする方法について説明します。このチュートリアルでは、Azure パブリック MEC ソリューションに仮想マシンとパブリック IP リソースをデプロイするために、Go で記述されたコードスニペットを提供します。同じモデルとテンプレートを使用して、Azure パブリック MEC でサポートされている他のリソースやサービスをデプロイすることができます。この記事は、Go のチュートリアルとして使用されることは意図されておらず、Azure パブリック MEC にリソースをデプロイするために必要な API 呼び出しにのみ焦点を当てています。

Go の詳細については、「Go 開発者向けの Azure」を参照してください。 Go のサンプルについては、Azure Go SDK サンプルを参照してください。

このチュートリアルでは、以下の内容を学習します。

仮想マシンの作成
パブリック IP アドレスの作成
仮想ネットワークとパブリック IP アドレスのデプロイ

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
許可リストに登録されているサブスクリプションを Azure アカウントに追加します。これにより、Azure パブリック MEC にリソースをデプロイできます。許可されたアクティブなサブスクリプションがない場合、Azure パブリック MEC 製品チームにお問い合わせください。

Go をインストールする

最新バージョンの Go をダウンロードしてインストールできます。マシン上の既存の Go が置き換えられます。同じコンピューターに複数の Go バージョンをインストールする場合は、Go インストールの管理を参照してください。

認証

Azure サービスを使用する前に認証を取得する必要があります。 Azure CLI を使用してサインインするか、認証環境変数を設定できます。

コマンドラインで az login を使用して、既定のブラウザーを使用して Azure にサインインできます。詳細な手順については、Azure CLI を使用したサインインを参照してください。

環境変数を設定する

Azure に対して認証するには、次の値が必要です:

サブスクリプション ID
クライアント ID
クライアントシークレット
テナント ID

次の手順に従って、ポータルからこれらの値を取得します:

サブスクリプション ID の取得
1. Azure アカウントにログインします
2. 左側のサイドバーで サブスクリプション を選択します
3. 必要なサブスクリプションを選択します
4. [概要] を選択します
5. サブスクリプション ID をコピーします
クライアント ID/クライアントシークレット/テナント ID を取得する

クライアント ID、クライアントシークレット、およびテナント ID を取得する方法については、「リソースにアクセスできる Microsoft Entra アプリケーションとサービスプリンシパルを作成する」を参照してください。
環境変数の設定

値を取得したら、環境変数として次の値を設定する必要があります:
- AZURE_CLIENT_ID
- AZURE_CLIENT_SECRET
- AZURE_TENANT_ID
- AZURE_SUBSCRIPTION_ID
開発システムで次の環境変数を設定するには:

Windows (管理者アクセスが必要)
1. コントロールパネルを開く
2. システムセキュリティ>システムの選択
3. 左側の 高度なシステム設定 を選択します
4. システムプロパティウィンドウで、Environment Variables… ボタンを選択します。
5. 変更するプロパティを選択し、編集... を選択します。プロパティ名が一覧に表示されない場合は、新規... を選択します。
Linux ベースの OS :
```
    export AZURE_CLIENT_SECRET="__CLIENT_SECRET__"
    export AZURE_TENANT_ID="__TENANT_ID__"
    export AZURE_SUBSCRIPTION_ID="__SUBSCRIPTION_ID__"````
```

パッケージをインストールする

新しい SDK では、バージョン管理と依存関係管理に Go モジュールが使用されます。

次のコマンドを実行して、このチュートリアルのパッケージをプロジェクトフォルダーにインストールします:

go get github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5
go get github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v3
go get github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources
go get github.com/Azure/azure-sdk-for-go/sdk/azcore
go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

仮想マシンのプロビジョニング

package main

import (
	"context"
	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v3"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/resources/armresources"
	"log"
	"os"
)

func main() {
	subscriptionId := os.Getenv("AZURE_SUBSCRIPTION_ID")

	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("authentication failure: %+v", err)
	}

	// client factory
	resourcesClientFactory, err := armresources.NewClientFactory(subscriptionId, cred, nil)
	if err != nil {
		log.Fatalf("cannot create client factory: %+v", err)
	}

	computeClientFactory, err := armcompute.NewClientFactory(subscriptionId, cred, nil)
	if err != nil {
		log.Fatalf("cannot create client factory: %+v", err)
	}

	networkClientFactory, err := armnetwork.NewClientFactory(subscriptionId, cred, nil)
	if err != nil {
		log.Fatalf("cannot create client factory: %+v", err)
	}

	// Step 1: Provision a resource group
	_, err = resourcesClientFactory.NewResourceGroupsClient().CreateOrUpdate(
		context.Background(),
		"<resourceGroupName>",
		armresources.ResourceGroup{
			Location: to.Ptr("westus"),
		},
		nil,
	)
	if err != nil {
		log.Fatal("cannot create resources group:", err)
	}

	// Step 2: Provision a virtual network
	virtualNetworksClientCreateOrUpdateResponsePoller, err := networkClientFactory.NewVirtualNetworksClient().BeginCreateOrUpdate(
		context.Background(),
		"<resourceGroupName>",
		"<virtualNetworkName>",
		armnetwork.VirtualNetwork{
			Location: to.Ptr("westus"),
			ExtendedLocation: &armnetwork.ExtendedLocation{
				Name: to.Ptr("<edgezoneid>"),
				Type: to.Ptr(armnetwork.ExtendedLocationTypesEdgeZone),
			},
			Properties: &armnetwork.VirtualNetworkPropertiesFormat{
				AddressSpace: &armnetwork.AddressSpace{
					AddressPrefixes: []*string{
						to.Ptr("10.0.0.0/16"),
					},
				},
				Subnets: []*armnetwork.Subnet{
					{
						Name: to.Ptr("test-1"),
						Properties: &armnetwork.SubnetPropertiesFormat{
							AddressPrefix: to.Ptr("10.0.0.0/24"),
						},
					},
				},
			},
		},
		nil,
	)
	if err != nil {
		log.Fatal("network creation failed", err)
	}
	virtualNetworksClientCreateOrUpdateResponse, err := virtualNetworksClientCreateOrUpdateResponsePoller.PollUntilDone(context.Background(), nil)
	if err != nil {
		log.Fatal("cannot create virtual network:", err)
	}
	subnetID := *virtualNetworksClientCreateOrUpdateResponse.Properties.Subnets[0].ID

	// Step 3: Provision an IP address
	publicIPAddressesClientCreateOrUpdateResponsePoller, err := networkClientFactory.NewPublicIPAddressesClient().BeginCreateOrUpdate(
		context.Background(),
		"<resourceGroupName>",
		"<publicIPName>",
		armnetwork.PublicIPAddress{
			Name:     to.Ptr("<publicIPName>"),
			Location: to.Ptr("westus"),
			ExtendedLocation: &armnetwork.ExtendedLocation{
				Name: to.Ptr("<edgezoneid>"),
				Type: to.Ptr(armnetwork.ExtendedLocationTypesEdgeZone),
			},
			SKU: &armnetwork.PublicIPAddressSKU{
				Name: to.Ptr(armnetwork.PublicIPAddressSKUNameStandard),
			},
			Properties: &armnetwork.PublicIPAddressPropertiesFormat{
				PublicIPAllocationMethod: to.Ptr(armnetwork.IPAllocationMethodStatic),
			},
		},
		nil,
	)
	if err != nil {
		log.Fatal("public ip creation failed", err)
	}
	publicIPAddressesClientCreateOrUpdateResponse, err := publicIPAddressesClientCreateOrUpdateResponsePoller.PollUntilDone(context.Background(), nil)
	if err != nil {
		log.Fatal("cannot create public ip: ", err)
	}

	// Step 4: Provision the network interface client
	interfacesClientCreateOrUpdateResponsePoller, err := networkClientFactory.NewInterfacesClient().BeginCreateOrUpdate(
		context.Background(),
		"<resourceGroupName>",
		"<networkInterfaceName>",
		armnetwork.Interface{
			Location: to.Ptr("westus"),
			ExtendedLocation: &armnetwork.ExtendedLocation{
				Name: to.Ptr("<edgezoneid>"),
				Type: to.Ptr(armnetwork.ExtendedLocationTypesEdgeZone),
			},
			Properties: &armnetwork.InterfacePropertiesFormat{
				EnableAcceleratedNetworking: to.Ptr(true),
				IPConfigurations: []*armnetwork.InterfaceIPConfiguration{
					{
						Name: to.Ptr("<ipConfigurationName>"),
						Properties: &armnetwork.InterfaceIPConfigurationPropertiesFormat{
							Subnet: &armnetwork.Subnet{
								ID: to.Ptr(subnetID),
							},
							PublicIPAddress: &armnetwork.PublicIPAddress{
								ID: publicIPAddressesClientCreateOrUpdateResponse.ID,
							},
						},
					},
				},
			},
		},
		nil,
	)
	if err != nil {
		log.Fatal("interface creation failed", err)
	}
	interfacesClientCreateOrUpdateResponse, err := interfacesClientCreateOrUpdateResponsePoller.PollUntilDone(context.Background(), nil)
	if err != nil {
		log.Fatal("cannot create interface:", err)
	}

	// Step 5: Provision the virtual machine
	virtualMachinesClientCreateOrUpdateResponsePoller, err := computeClientFactory.NewVirtualMachinesClient().BeginCreateOrUpdate(
		context.Background(),
		"<resourceGroupName>",
		"<vmName>",
		armcompute.VirtualMachine{
			Location: to.Ptr("westus"),
			ExtendedLocation: &armcompute.ExtendedLocation{
				Name: to.Ptr("<edgezoneid>"),
				Type: to.Ptr(armcompute.ExtendedLocationTypesEdgeZone),
			},
			Properties: &armcompute.VirtualMachineProperties{
				StorageProfile: &armcompute.StorageProfile{
					ImageReference: &armcompute.ImageReference{
						Publisher: to.Ptr("<publisher>"),
						Offer:     to.Ptr("<offer>"),
						SKU:       to.Ptr("<sku>"),
						Version:   to.Ptr("<version>"),
					},
				},
				HardwareProfile: &armcompute.HardwareProfile{
					VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2SV3),
				},
				OSProfile: &armcompute.OSProfile{
					ComputerName:  to.Ptr("<computerName>"),
					AdminUsername: to.Ptr("<adminUsername>"),
					AdminPassword: to.Ptr("<adminPassword>"),
				},
				NetworkProfile: &armcompute.NetworkProfile{
					NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
						{
							ID: interfacesClientCreateOrUpdateResponse.ID,
							Properties: &armcompute.NetworkInterfaceReferenceProperties{
								Primary: to.Ptr(true),
							},
						},
					},
				},
			},
		},
		nil,
	)
	if err != nil {
		log.Fatal("virtual machine creation failed", err)
	}
	_, err = virtualMachinesClientCreateOrUpdateResponsePoller.PollUntilDone(context.Background(), nil)
	if err != nil {
		log.Fatal("cannot create virtual machine:", err)
	}
}

リソースをクリーンアップする

このチュートリアルでは、Go SDK を使用して Azure パブリック MEC に VM を作成しました。これらのリソースが今後不要となる場合は、Azure portal を使用して、作成したリソースグループを削除します。

次のステップ

Python SDK を使用して Azure パブリック MEC に仮想マシンをデプロイする方法については、次の記事を参照してください。

チュートリアル: Python SDK を使用した Azure パブリック MEC への仮想マシンのデプロイ

次の方法で共有

チュートリアル: Go SDK を使用した Azure パブリック MEC へのリソースのデプロイに関する記事

前提条件

Go をインストールする

認証

環境変数を設定する

パッケージをインストールする

仮想マシンのプロビジョニング

リソースをクリーンアップする

次のステップ

その他のリソース

次の方法で共有

チュートリアル: Go SDK を使用した Azure パブリック MEC へのリソースのデプロイに関する記事

前提条件

Go をインストールする

認証

Azure CLI を使用してサインインします

環境変数を設定する

パッケージをインストールする

仮想マシンのプロビジョニング

リソースをクリーンアップする

次のステップ

その他のリソース