クイックスタート: az postgres up コマンドを使用して、Azure Database for PostgreSQL - Single Server を作成する
適用対象:
Azure Database for PostgreSQL - 単一サーバー
重要
Azure Database for PostgreSQL - シングル サーバーは廃止パスにあります。 Azure Database for PostgreSQL - フレキシブル サーバーにアップグレードすることを強くお勧めします。 Azure Database for PostgreSQL - フレキシブル サーバーへの移行の詳細については、Azure Database for PostgreSQL 単一サーバーの現状に関するページを参照してください。
Azure Database for PostgreSQL は、高可用性 PostgreSQL データベースをクラウドで実行、管理、および拡張することができる、管理されたサービスです。 Azure CLI は、コマンドラインやスクリプトで Azure リソースを作成および管理するために使用します。 このクイック スタートでは、az postgres up コマンドを使用し、Azure CLI を使って Azure Database for PostgreSQL サーバーを作成する方法を示します。 サーバーの作成に加え、az postgres up コマンドではサンプル データベース、データベースのルート ユーザーを作成し、Azure サービスのファイアウォールを開き、クライアント コンピューターの既定のファイアウォール規則を作成します。 これらの既定値は、開発プロセスを促進するために役立ちます。
Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
Azure Database for PostgreSQL サーバーの作成
前提条件
Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。
初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
Azure Cloud Shell を起動する
Azure Cloud Shell は無料のインタラクティブ シェルです。この記事の手順は、Azure Cloud Shell を使って実行することができます。 一般的な Azure ツールが事前にインストールされており、アカウントで使用できるように構成されています。
Cloud Shell を開くには、コード ブロックの右上隅にある [使ってみる] を選択します。 https://shell.azure.com に移動して、別のブラウザー タブで Cloud Shell を起動することもできます。
Cloud Shell が開いたら、お使いの環境に対して Bash が選択されていることを確認します。 後続のセッションでは、Bash 環境で Azure CLI を使用します。[コピー] を選択してコードのブロックをコピーし、Cloud Shell に貼り付けます。その後、Enter キーを押してそれを実行します。
Azure へのサインイン
Cloud Shell は、サインインした最初のアカウントで自動的に認証されます。 別のサブスクリプションを使用してサインインするには、次のスクリプトを使用し、<Subscription ID> をご使用の Azure サブスクリプション ID に置き換えます。 Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
詳細については、アクティブなサブスクリプションの設定または対話形式のログインに関する記事を参照してください
db-up 拡張機能をインストールします。 エラーが返された場合は、最新バージョンの Azure CLI がインストールされていることを確認してください。 Azure CLI のインストールに関するページを参照してください。
az extension add --name db-up
次のコマンドを使用して、Azure Database for PostgreSQL サーバーを作成します。
az postgres up
サーバーは以下の既定値で作成されます (これらを手動でオーバーライドしない限り)。
| 設定 | 既定値 | 説明 |
|---|---|---|
| server-name | システム生成 | Azure Database for PostgreSQL サーバーを識別する一意の名前。 |
| resource-group | システム生成 | 新しい Azure リソース グループ。 |
| sku-name | GP_Gen5_2 | SKU の名前。 省略表現の {価格レベル}_{コンピューティング世代}_{仮想コア} という規則に従います。 既定値は、2 個の仮想コアを備えた General Purpose Gen5 サーバーです。 レベルの詳細については、価格に関するページを参照してください。 |
| backup-retention | 7 | バックアップが保持される期間。 単位は日数です。 |
| geo-redundant-backup | 無効 | このサーバーに対して geo 冗長バックアップを有効にする必要があるかどうかどうか。 |
| location | westus2 | サーバーの Azure の場所。 |
| ssl-enforcement | 無効 | このサーバーに対して TLS/SSL を有効にする必要があるかどうかどうか。 |
| storage-size | 5120 | サーバーのストレージ容量 (単位はメガバイト)。 |
| version | 10 | PostgreSQL のメジャー バージョン。 |
| admin-user | システム生成 | 管理者のユーザー名。 |
| admin-password | システム生成 | 管理者ユーザーのパスワード。 |
注意
az postgres up コマンドとその追加パラメーターの詳細については、Azure CLI のドキュメントを参照してください。
サーバーが作成されると、設定は次のようになります。
- "devbox" というファイアウォール規則が作成されます。 Azure CLI では、
az postgres upコマンドの実行元となるマシンの IP アドレスの検出が試行され、その IP アドレスが許可されます。 - [Azure サービスへのアクセスを許可] が [オン] に設定されます。 この設定により、サブスクリプションにはないリソースを含む、すべての Azure リソースからの接続を受け入れるようにサーバーのファイアウォールが構成されます。
- "sampledb" という名前の空のデータベースが作成されます
- "sampledb" に対する特権を持つ "root" という名前の新しいユーザーが作成されます
注意
Azure Database for PostgreSQL はポート 5432 経由で通信を行います。 企業ネットワーク内から接続しようとしても、ポート 5432 での送信トラフィックがネットワークのファイアウォールで禁止されている場合があります。 サーバーに接続するには、IT 部門にポート 5432 を開放してもらう必要があります。
接続情報の取得
az postgres up コマンドが完了した後、一般的なプログラミング言語の接続文字列のリストが返されます。 これらの接続文字列は、新しく作成した Azure Database for PostgreSQL サーバーの特定の属性で事前に構成されています。
az postgres show-connection-string コマンドを使用して、これらの接続文字列をもう一度リストすることができます。
リソースをクリーンアップする
以下のコマンドを使用して、クイック スタートで作成したすべてのリソースをクリーンアップします。 このコマンドによって、Azure Database for PostgreSQL サーバーとリソース グループが削除されます。
az postgres down --delete-group
新しく作成したサーバーを削除するだけの場合は、az postgres down コマンドを実行できます。
az postgres down