CLI を使用して Azure Database for PostgreSQL 単一サーバー用の Private Link を作成および管理する

[アーティクル]
04/03/2023

適用対象: Azure Database for PostgreSQL - 単一サーバー

重要

Azure Database for PostgreSQL - シングルサーバーは廃止パスにあります。 Azure Database for PostgreSQL - フレキシブルサーバーにアップグレードすることを強くお勧めします。 Azure Database for PostgreSQL - フレキシブルサーバーへの移行の詳細については、Azure Database for PostgreSQL 単一サーバーの現状に関するページを参照してください。

プライベートエンドポイントは、Azure におけるプライベートリンクの基本的な構成要素です。これによって、仮想マシン (VM) などの Azure リソースが Private Link リソースと非公開で通信できるようになります。この記事では、Azure CLI を使用して Azure Virtual Network 内に VM を作成し、Azure プライベートエンドポイントを含む Azure Database for PostgreSQL 単一サーバーを作成する方法について説明します。

注意

プライベートリンク機能は、General Purpose または Memory Optimized のいずれかの価格レベルの Azure Database for PostgreSQL サーバーでのみ使用できます。データベースサーバーがこれらの価格レベルのいずれであるかを確認します。

前提条件

このハウツーガイドの手順を実行するには、以下が必要です。

Azure Database for PostgreSQL サーバーとデータベース。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。

代わりに Azure CLI をローカルにインストールして使用する場合は、このクイックスタートには Azure CLI バージョン 2.0.28 以降を使用する必要があります。インストールされているバージョンを確認するには、az --version を実行します。インストールまたはアップグレードについては、「Azure CLI のインストール」をご覧ください。

リソースグループを作成する

リソースを作成するには、その前に、仮想ネットワークをホストするリソースグループを作成する必要があります。 az group create を使用して、リソースグループを作成します。この例では、westeurope の場所に myResourceGroup という名前のリソースグループを作成します。

az group create --name myResourceGroup --location westeurope

仮想ネットワークを作成します

az network vnet create を使用して仮想ネットワークを作成します。この例では、mySubnet という名前のサブネットを使って、myVirtualNetwork という名前の既定の仮想ネットワークを作成します。

az network vnet create \
--name myVirtualNetwork \
--resource-group myResourceGroup \
--subnet-name mySubnet

サブネットのプライベートエンドポイントポリシーを無効にする

Azure では仮想ネットワーク内のサブネットにリソースがデプロイされるため、プライベートエンドポイントのネットワークポリシーを無効にするようにサブネットを作成または更新する必要があります。 az network vnet subnet update を使用して  mySubnet  という名前のサブネット構成を更新します。

az network vnet subnet update \
--name mySubnet \
--resource-group myResourceGroup \
--vnet-name myVirtualNetwork \
--disable-private-endpoint-network-policies true

VM の作成

az vm create を使って VM を作成します。メッセージが表示されたら、VM のサインイン資格情報として使用するパスワードを入力します。この例では、myVm という名前の VM を作成します。

az vm create \
  --resource-group myResourceGroup \
  --name myVm \
  --image Win2019Datacenter

VM のパブリック IP アドレスを書き留めます。このアドレスは、次の手順でインターネットから VM に接続するために使用します。

Azure Database for PostgreSQL 単一サーバーを作成する

az postgres server create コマンドを使用して Azure Database for PostgreSQL を作成します。 PostgreSQL サーバーの名前は Azure 全体で一意である必要があるため、プレースホルダー値を、上記で使用した独自の一意の値に置き換えることを忘れないでください。

# Create a server in the resource group

[!INCLUDE [applies-to-postgresql-single-server](../includes/applies-to-postgresql-single-server.md)]

[!INCLUDE [azure-database-for-postgresql-single-server-deprecation](../includes/azure-database-for-postgresql-single-server-deprecation.md)]


az postgres server create \
--name mydemoserver \
--resource-group myresourcegroup \
--location westeurope \
--admin-user mylogin \
--admin-password <server_admin_password> \
--sku-name GP_Gen5_2

プライベートエンドポイントを作成する

Virtual Network 内に PostgreSQL サーバーのプライベートエンドポイントを作成します。

az network private-endpoint create \  
    --name myPrivateEndpoint \  
    --resource-group myResourceGroup \  
    --vnet-name myVirtualNetwork  \  
    --subnet mySubnet \  
    --private-connection-resource-id $(az resource show -g myResourcegroup -n mydemoserver --resource-type "Microsoft.DBforPostgreSQL/servers" --query "id" -o tsv) \    
    --group-id postgresqlServer \  
    --connection-name myConnection

プライベート DNS ゾーンを構成する

PostgreSQL サーバードメイン用のプライベート DNS ゾーンを作成し、Virtual Network との関連付けリンクを作成します。

az network private-dns zone create --resource-group myResourceGroup \ 
   --name  "privatelink.postgres.database.azure.com" 
az network private-dns link vnet create --resource-group myResourceGroup \ 
   --zone-name  "privatelink.postgres.database.azure.com"\ 
   --name MyDNSLink \ 
   --virtual-network myVirtualNetwork \ 
   --registration-enabled false

#Query for the network interface ID  

networkInterfaceId=$(az network private-endpoint show --name myPrivateEndpoint --resource-group myResourceGroup --query 'networkInterfaces[0].id' -o tsv)


az resource show --ids $networkInterfaceId --api-version 2019-04-01 -o json
# Copy the content for privateIPAddress and FQDN matching the Azure database for PostgreSQL name

[!INCLUDE [applies-to-postgresql-single-server](../includes/applies-to-postgresql-single-server.md)]

[!INCLUDE [azure-database-for-postgresql-single-server-deprecation](../includes/azure-database-for-postgresql-single-server-deprecation.md)]


#Create DNS records 

az network private-dns record-set a create --name myserver --zone-name privatelink.postgres.database.azure.com --resource-group myResourceGroup  
az network private-dns record-set a add-record --record-set-name myserver --zone-name privatelink.postgres.database.azure.com --resource-group myResourceGroup -a <Private IP Address>

注意

お客様の DNS 設定の FQDN は、構成されている非公開 IP では解決されません。こちらで示すように、構成された FQDN の DNS ゾーンを設定する必要があります。

注意

Azure Database for PostgreSQL と VNet サブネットが異なるサブスクリプションに存在する場合があります。このような場合は、次の構成を確認する必要があります。

両方のサブスクリプションに Microsoft.DBforPostgreSQL リソースプロバイダーが登録されていることを確認してください。詳細については、リソースプロバイダーに関する記事をご覧ください。

インターネットから VM に接続する

次のように、インターネットから VM myVm に接続します。

ポータルの検索バーに、「myVm」と入力します。
[接続] を選択します。 [接続] ボタンを選択すると、 [Connect to virtual machine](仮想マシンに接続する) が開きます。
[RDP ファイルのダウンロード] を選択します。リモートデスクトッププロトコル ( .rdp) ファイルが作成され、お使いのコンピューターにダウンロードされます。
downloaded.rdp ファイルを開きます。
1. メッセージが表示されたら、 [Connect] を選択します。
2. VM の作成時に指定したユーザー名とパスワードを入力します。
  
  Note
  
  場合によっては、[その他]>[別のアカウントを使用する] を選択して、VM の作成時に入力した資格情報を指定する必要があります。
[OK] を選択します。
サインイン処理中に証明書の警告が表示される場合があります。証明書の警告を受信する場合は、 [はい] または [続行] を選択します。
VM デスクトップが表示されたら最小化してローカルデスクトップに戻ります。

VM から PostgreSQL サーバーにプライベートにアクセスする

myVM のリモートデスクトップで、PowerShell を開きます。

「nslookup mydemopostgresserver.privatelink.postgres.database.azure.com」と入力します。

次のようなメッセージが返されます。

Server:  UnKnown
Address:  168.63.129.16
Non-authoritative answer:
Name:    mydemopostgresserver.privatelink.postgres.database.azure.com
Address:  10.1.3.4

使用可能な任意のクライアントを使用して、PostgreSQL サーバーのプライベートリンク接続をテストします。次の例では Azure Data Studio を使用して操作を実行します。

[新しい接続] で、この情報を入力または選択します。

設定	値
サーバーの種類	[PostgreSQL] を選択します。
サーバー名	[mydemopostgresserver.privatelink.postgres.database.azure.com] を選択します。
ユーザー名	PostgreSQL サーバーの作成時に指定されるユーザー名を「username@servername」として入力します。
Password	PostgreSQL サーバーの作成時に指定したパスワードを入力します。
SSL	[必須] を選択します。

[接続] を選択します。
左側のメニューでデータベースを参照します。
(省略可能) postgreSQL サーバーから情報を作成またはクエリします。
myVm へのリモートデスクトップ接続を閉じます。

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

不要になったら、az group delete を使って、リソースグループとそのすべてのリソースを削除できます。

az group delete --name myResourceGroup --yes

次のステップ

Azure プライベートエンドポイントの概要について学習します。