CLI'dan Azure Arc özellikli bir PostgreSQL sunucusu oluşturma

Bu belgede, Azure Arc'ta PostgreSQL sunucusu oluşturma ve sunucuya bağlanma adımları açıklanmaktadır.

Önkoşullar

Bu makaledeki görevlere devam etmeden önce gerekli araçlara sahip olmanız gerekir. Tüm dağıtımlar için aşağıdaki araçlar gerekir:

• Azure Data Studio

• Azure Data Studio için Azure Arc uzantısı

• Azure CLI (az)

• arcdata Azure CLI uzantısı

• kubectl

  Ortamınıza bağlı olarak ek istemci araçları. Daha kapsamlı bir liste için bkz . İstemci araçları.

Gerekli araçlara ek olarak, görevleri tamamlamak için bir Azure Arc veri denetleyicisine ihtiyacınız vardır.

Başlarken

Aşağıdaki konuları zaten biliyorsanız, bu paragrafı atlayabilirsiniz. Oluşturma işlemine devam etmeden önce okumak isteyebileceğiniz önemli konular vardır:

• Azure Arc özellikli veri hizmetlerine genel bakış
• Bağlantı modları ve gereksinimleri
• Depolama yapılandırması ve Kubernetes depolama kavramları
• Kubernetes kaynak modeli

Tam bir ortam sağlamadan iş yapmayı tercih ediyorsanız Azure Kubernetes Service (AKS), AWS Elastic Kubernetes Service (EKS), Google Cloud Kubernetes Engine (GKE) veya bir Azure VM'de Azure Arc Jumpstart ile hızlı bir şekilde çalışmaya başlayın.

Yalnızca OpenShift kullanıcıları için ön ve geçici adım

Sonraki adıma geçmeden önce bu adımı uygulayın. PostgreSQL sunucusunu varsayılan dışındaki bir projede Red Hat OpenShift'e dağıtmak için, güvenlik kısıtlamalarını güncelleştirmek için kümenizde aşağıdaki komutları yürütmeniz gerekir. Bu komut, PostgreSQL sunucunuzu çalıştıracak hizmet hesaplarına gerekli ayrıcalıkları verir. Güvenlik bağlamı kısıtlaması (SCC) arc-data-scc, Azure Arc veri denetleyicisini dağıttığınızda eklediğiniz kısıtlamadır.

oc adm policy add-scc-to-user arc-data-scc -z <server-name> -n <namespace-name>

Sunucu adı, sonraki adımda oluşturacağınız sunucunun adıdır.

OpenShift'teki SCC'ler hakkında daha fazla bilgi için OpenShift belgelerine bakın. Sonraki adıma geçin.

Azure Arc özellikli postgreSQL sunucusu oluşturma

Arc veri denetleyicinizde Azure Arc özellikli bir PostgreSQL sunucusu oluşturmak için, birkaç parametre geçireceğiniz komutu az postgres server-arc create kullanacaksınız.

Oluşturma zamanında ayarlayabileceğiniz tüm parametreler hakkında ayrıntılı bilgi için komutun çıkışını gözden geçirin:

az postgres server-arc create --help

Dikkate alınması gereken ana parametreler şunlardır:

• dağıtmak istediğiniz sunucunun adı. --name Uzunluğu 11 karakteri aşmaması gereken bir ad belirtin veya -n bunu takip edin.

• Sunucunuzun kullanmasını istediğiniz depolama sınıfları . Sunucu dağıttığınızda depolama sınıfını doğru ayarlamanız önemlidir, bu ayar dağıtıldıktan sonra değiştirilemez. Veriler, günlükler ve yedeklemeler için kullanılacak depolama sınıflarını belirtebilirsiniz. Varsayılan olarak, depolama sınıflarını belirtmezseniz, veri denetleyicisinin depolama sınıfları kullanılır.

  • Yedeklemeler için depolama sınıfını ayarlamak için parametresini --storage-class-backups ve ardından depolama sınıfının adını belirtin. Bu parametrenin dışlanması otomatik yedeklemeleri devre dışı bırakır
  • Verilerin depolama sınıfını ayarlamak için parametresini --storage-class-data ve ardından depolama sınıfının adını belirtin.
  • Günlüklerin depolama sınıfını ayarlamak için parametresini --storage-class-logs ve ardından depolama sınıfının adını belirtin.

  Önemli

  Dağıtımdan sonra depolama sınıfını değiştirmeniz gerekiyorsa verileri ayıklayın, sunucunuzu silin, yeni bir sunucu oluşturun ve verileri içeri aktarın.

Create komutunu yürütürken, yönetici kullanıcının kullanıcı adını ve parolasını girmeniz istenir. create komutunu çalıştırmadan önce ve AZDATA_PASSWORD oturum ortamı değişkenlerini ayarlayarak AZDATA_USERNAME etkileşimli istemi atlayabilirsiniz.

Örnekler

Veri denetleyicisiyle aynı depolama sınıflarını kullanan postgres01 adlı bir PostgreSQL sunucusu dağıtmak için aşağıdaki komutu çalıştırın:

az postgres server-arc create -n postgres01 --k8s-namespace <namespace> --use-k8s

Arc veri denetleyicinizde dağıtılan PostgreSQL sunucularını listeleme

Arc veri denetleyicinizde dağıtılan PostgreSQL sunucularını listelemek için aşağıdaki komutu çalıştırın:

az postgres server-arc list --k8s-namespace <namespace> --use-k8s

  {
    "name": "postgres01",
    "state": "Ready"
  }

Azure Arc özellikli PostgreSQL sunucularınıza bağlanmak için uç noktaları alma

PostgreSQL sunucusunun uç noktalarını görüntülemek için aşağıdaki komutu çalıştırın:

az postgres server-arc endpoint list -n <server name> --k8s-namespace <namespace> --use-k8s

Örneğin:

{
  "instances": [
    {
      "endpoints": [
        {
          "description": "PostgreSQL Instance",
          "endpoint": "postgresql://postgres:<replace with password>@123.456.78.912:5432"
        },
        {
          "description": "Log Search Dashboard",
        },
        {
          "description": "Metrics Dashboard",
          "endpoint": "https://98.765.432.11:3000/d/postgres-metrics?var-Namespace=arc&var-Name=postgres01"
        }
      ],
      "engine": "PostgreSql",
      "name": "postgres01"
    }
  ],
  "namespace": "arc"
}

Sık kullandığınız araçtan PostgreSQL sunucusuna bağlanmak için PostgreSQL Örneği uç noktasını kullanabilirsiniz: Azure Data Studio, pgcli psql, pgAdmin vb.

Şu anda Azure Data Studio'nun insider derlemesini kullanın.

Azure sanal makine dağıtımları hakkında özel not

Azure sanal makinesi kullanırken uç nokta IP adresi genel IP adresini göstermez. Genel IP adresini bulmak için aşağıdaki komutu kullanın:

az network public-ip list -g azurearcvm-rg --query "[].{PublicIP:ipAddress}" -o table

Daha sonra bağlantınızı oluşturmak için genel IP adresini bağlantı noktasıyla birleştirebilirsiniz.

PostgreSQL sunucusunun bağlantı noktasını ağ güvenlik ağ geçidi (NSG) aracılığıyla da kullanıma sunmanız gerekebilir. (NSG) üzerinden trafiğe izin vermek için bir kural ayarlayın. Kural ayarlamak için NSG'nizin adını bilmeniz gerekir. NSG'yi aşağıdaki komutu kullanarak belirlersiniz:

az network nsg list -g azurearcvm-rg --query "[].{NSGName:name}" -o table

NSG'nin adını aldıktan sonra aşağıdaki komutu kullanarak bir güvenlik duvarı kuralı ekleyebilirsiniz. Buradaki örnek değerler 30655 numaralı bağlantı noktası için bir NSG kuralı oluşturur ve herhangi bir kaynak IP adresinden bağlantıya izin verir.

Aşağıdaki parametrenin --destination-port-ranges değerini yukarıdaki komuttan az postgres server-arc list edindiğiniz bağlantı noktası numarasıyla değiştirin.

az network nsg rule create -n db_port --destination-port-ranges 30655 --source-address-prefixes '*' --nsg-name azurearcvmNSG --priority 500 -g azurearcvm-rg --access Allow --description 'Allow port through for db access' --destination-address-prefixes '*' --direction Inbound --protocol Tcp --source-port-ranges '*'

Azure Data Studio ile bağlanma

Azure Data Studio'yu açın ve yukarıdaki dış uç nokta IP adresi ve bağlantı noktası numarası ile örneğinizi oluştururken belirttiğiniz parolayla örneğinize bağlanın. Bağlantı türü açılan listesinde PostgreSQL yoksa, uzantılar sekmesinde PostgreSQL'i arayarak PostgreSQL uzantısını yükleyebilirsiniz.

Bir Azure VM kullanıyorsanız aşağıdaki komutla erişilebilen genel IP adresine ihtiyacınız olacağını unutmayın:

az network public-ip list -g azurearcvm-rg --query "[].{PublicIP:ipAddress}" -o table

psql ile bağlanma

PostgreSQL sunucunuza erişmek için yukarıdan aldığınız PostgreSQL sunucusunun dış uç noktasını geçirin:

Artık iki psql'den birini bağlayabilirsiniz:

psql postgresql://postgres:<EnterYourPassword>@10.0.0.4:30655

İlgili içerik

• Azure Arc özellikli PostgreSQL sunucunuza bağlanma: Bağlantı Uç Noktalarını ve Bağlantı Dizelerini Alma bölümünü okuyun

  * Yukarıdaki belgelerde Azure portalında oturum açma ve PostgreSQL için Azure Veritabanı oluşturma bölümlerini atlayın. Azure Arc dağıtımınızda kalan adımları uygulayın. Bu bölümler, Azure bulutunda PaaS hizmeti olarak sunulan PostgreSQL için Azure Veritabanı sunucusuna özeldir, ancak belgelerin diğer bölümleri Doğrudan Azure Arc özellikli PostgreSQL sunucunuz için geçerlidir.

• Depolama yapılandırması ve Kubernetes depolama kavramları

• Kalıcı birim taleplerini genişletme

• Kubernetes kaynak modeli