Mulai cepat: Membuat server Azure Database for PostgreSQL menggunakan portal Azure CLI

  • Artikel

BERLAKU UNTUK: Azure Database for PostgreSQL - Server Tunggal

Penting

Azure Database for PostgreSQL - Server Tunggal berada di jalur penghentian. Kami sangat menyarankan Agar Anda meningkatkan ke Azure Database for PostgreSQL - Server Fleksibel. Untuk informasi selengkapnya tentang migrasi ke Azure Database for PostgreSQL - Server Fleksibel, lihat Apa yang terjadi pada Server Tunggal Azure Database for PostgreSQL?.

Mulai cepat ini memperlihatkan cara menggunakan perintah Azure CLI di Azure Cloud Shell untuk membuat server Azure Database for PostgreSQL dalam waktu lima menit.

Tip

Pertimbangkan untuk menggunakan perintah az postgres up Azure CLI yang lebih sederhana. Cobalah mulai cepat.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

Meluncurkan Azure Cloud Shell

Azure Cloud Shell adalah shell interaktif gratis yang dapat Anda gunakan untuk menjalankan langkah-langkah dalam artikel ini. Shell ini memiliki alat Azure umum yang telah dipasang sebelumnya dan dikonfigurasi untuk digunakan dengan akun Anda.

Untuk membuka Cloud Shell, cukup pilih Cobalah dari sudut kanan atas blok kode. Anda juga dapat meluncurkan Cloud Shell di tab browser terpisah dengan membuka https://shell.azure.com.

Saat Cloud Shell terbuka, verifikasi bahwa Bash dipilih untuk lingkungan Anda. Sesi berikutnya akan menggunakan Azure CLI dalam lingkungan Bash, Pilih Salin untuk menyalin blok kode, tempelkan ke Cloud Shell, lalu tekan Enter untuk menjalankannya.

Masuk ke Azure

Cloud Shell diautentikasi secara otomatis dengan akun awal yang digunakan untuk masuk. Gunakan skrip berikut untuk masuk menggunakan langganan yang berbeda, menggantikan <Subscription ID> dengan ID Langganan Azure Anda. Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

Untuk informasi selengkapnya, lihat mengatur langganan aktif atau masuk secara interaktif

Menetapkan nilai parameter

Nilai berikut digunakan dalam perintah berikutnya untuk membuat database dan sumber daya yang diperlukan. Nama server harus unik secara global di seluruh Azure sehingga $RANDOM fungsi ini digunakan untuk membuat nama server.

Ubah lokasi yang sesuai untuk lingkungan Anda. Ganti nilai 0.0.0.0 di rentang alamat ip agar sesuai dengan lingkungan tertentu Anda. Gunakan alamat IP publik komputer yang sedang Anda gunakan untuk membatasi akses ke server agar hanya menuju ke alamat IP Anda.

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-postgresql-rg-$randomIdentifier"
tag="create-postgresql-server-and-firewall-rule"
server="msdocs-postgresql-server-$randomIdentifier"
sku="GP_Gen5_2"
login="azureuser"
password="Pa$$w0rD-$randomIdentifier"
# Specify appropriate IP address values for your environment
# to limit / allow access to the PostgreSQL server
startIp=0.0.0.0
endIp=0.0.0.0
echo "Using resource group $resourceGroup with login: $login, password: $password..."

Buat grup sumber daya

Buat grup sumber daya dengan perintah az group create. Grup sumber daya Azure adalah kontainer logis tempat sumber daya Azure disebarkan dan dikelola. Contoh berikut ini menampilkan cara membuat grup sumber daya bernama myResourceGroup di lokasi eastus:

# Create a resource group
echo "Creating $resourceGroup in $location..."
az group create --name $resourceGroup --location "$location" --tags $tag

Membuat server

Buat server dengan perintah az postgres server create.

# Create a PostgreSQL server in the resource group
# Name of a server maps to DNS name and is thus required to be globally unique in Azure.
echo "Creating $server in $location..."
az postgres server create --name $server --resource-group $resourceGroup --location "$location" --admin-user $login --admin-password $password --sku-name $sku

Catatan

  • Nama server hanya boleh berisi huruf kecil, angka, dan karakter tanda hubung (-). Nama ini harus berisi 3 hingga 63 karakter. Untuk informasi selengkapnya, lihat Aturan Penamaan Azure Database for PostgreSQL.
  • Nama pengguna untuk pengguna admin tidak boleh azure_superuser, admin, administrator, root, guest, atau publik.
  • Kata sandi harus berisi karakter 8 hingga 128 dari tiga kategori berikut: huruf besar bahasa Inggris, huruf kecil bahasa Inggris, angka, dan karakter nonalfanumerik.
  • Untuk informasi tentang SKU, lihat Harga Azure Database for PostgreSQL.

Penting

Mengonfigurasi aturan firewall berbasis server

Buat aturan firewall dengan perintah az postgres server firewall-rule create untuk memberikan akses lingkungan lokal Anda untuk terhubung ke server.

# Configure a firewall rule for the server 
echo "Configuring a firewall rule for $server for the IP address range of $startIp to $endIp"
az postgres server firewall-rule create --resource-group $resourceGroup --server $server --name AllowIps --start-ip-address $startIp --end-ip-address $endIp

Tip

Jika Anda tidak tahu alamat IP Anda, buka WhatIsMyIPAddress.com untuk mendapatkannya.

Catatan

Untuk menghindari masalah konektivitas, pastikan firewall jaringan Anda mengizinkan port 5432. Server Azure Database for PostgreSQL menggunakan port itu.

Mencantumkan aturan firewall berbasis server

Untuk membuat daftar aturan firewall server yang ada, jalankan perintah daftar aturan firewall server az postgres.

# List firewall rules for the server
echo "List of server-based firewall rules for $server"
az postgres server firewall-rule list --resource-group $resourceGroup --server-name $server
# You may use the switch `--output table` for a more readable table format as the output.

Output mencantumkan aturan firewall, jika ada, secara default dalam format JSON. Anda dapat menggunakan sakelar --output table untuk format tabel yang lebih mudah dibaca sebagai output.

Mendapatkan informasi sambungan

Agar tersambung ke server, Anda perlu memasukkan informasi host dan kredensial akses.

az postgres server show --resource-group $resourceGroup --name $server

Buat catatan nilai administratorLogin dan fullyQualifiedDomainName.

Menyambungkan ke server Azure Database for PostgreSQL dengan menggunakan psql

Klien psql adalah pilihan populer untuk tersambung ke server PostgreSQL. Anda dapat terhubung ke server Anda dengan menggunakan psql dengan Azure Cloud Shell. Anda juga dapat menggunakan psql pada lingkungan lokal Anda jika Anda memilikinya tersedia. Database kosong, postgres, secara otomatis dibuat dengan server PostgreSQL baru. Anda dapat menggunakan database itu untuk terhubung dengan psql, seperti yang ditunjukkan dalam kode berikut.

psql --host=<server_name>.postgres.database.azure.com --port=5432 --username=<admin_user>@<server_name> --dbname=postgres

Tip

Jika Anda lebih suka menggunakan jalur URL untuk terhubung ke Postgres, URL mengodekan tanda @ di nama pengguna dengan %40. Misalnya, string koneksi untuk psql adalah:

psql postgresql://<admin_user>%40<server_name>@<server_name>.postgres.database.azure.com:5432/postgres

Membersihkan sumber daya

Gunakan perintah berikut untuk menghapus grup sumber daya dan semua sumber daya yang terkait dengannya menggunakan perintah az group delete - kecuali Anda masih memiliki kebutuhan untuk sumber daya ini. Beberapa sumber daya ini mungkin membutuhkan beberapa waktu untuk dibuat dan dihapus.

az group delete --name $resourceGroup

Langkah berikutnya

Mendesain Azure Database for PostgreSQL pertama Anda menggunakan CLI Azure