Azure Container Instances'a Veri API oluşturucusu dağıtma

Dağıtım kılavuzundaki dizideki geçerli konum ('Yayımla') diyagramı.

Veri API'si oluşturucusunu yalnızca bir yapılandırma dosyası kullanarak ve özel kod kullanmadan Azure'a hızla dağıtın. Bu kılavuz, Azure Container Instances'ta Kapsayıcı olarak Docker'dan Veri API oluşturucusu kapsayıcı görüntüsünü barındırma adımlarını içerir.

Bu kılavuzda, Veri API'sini oluşturucu yapılandırma dosyası oluşturma, dosyayı Azure Dosyalar'da barındırma ve ardından dosyayı Azure Container Instances'taki bir kapsayıcıya bağlama adımlarını izleyin.

Önkoşullar

Aktif bir aboneliğe sahip bir Azure hesabı. Ücretsiz hesap oluşturun.
Veri API'si oluşturucu CLI. CLI'yi yükleyin.
Azure CLI. Azure CLI'yi yükleyin.
Azure'dan adreslenebilen mevcut desteklenen veritabanı.

Yapılandırma dosyasını oluşturma

Başlamak için, mevcut veritabanınıza bağlanmak için bir Veri API'si oluşturucu (DAB) yapılandırma dosyası oluşturun. Bu dosya daha sonra son kapsayıcıda kullanılır.

Yapılandırma dosyasını depolamak için yerel makinenizde boş bir dizin oluşturun.

kullanarak dab inityeni bir temel yapılandırma dosyası başlatın. Başlatma sırasında en az aşağıdaki ayarları kullanın.

Ayarlar	Değer
Veritabanı türü	Desteklenen bir veritabanı türü seçin.
Bağlantı dizesi	`@env()` ortam değişkenine başvurmak için `DATABASE_CONNECTION_STRING` işlevini kullanın.

dab init --database-type "<database-type>" --connection-string "@env('DATABASE_CONNECTION_STRING')"

Önemli

Bazı veritabanı türleri başlatmada ek yapılandırma ayarları gerektirir.

Yapılandırmaya en az bir veritabanı varlığı ekleyin. dab add Bir varlığı yapılandırmak için komutunu kullanın. Her varlığı anonim kullanıcılar için tüm izinlere izin verecek şekilde yapılandırın. dab add'yi varlıklarınız için istediğiniz kadar tekrarlayın.
```
dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*"
```
dab-config.json dosyasının içeriğini açın ve gözden geçirin. Bu dosyayı bu kılavuzun ilerleyen bölümlerinde kullanacaksınız.

Azure Dosyalar'da konak yapılandırması

Ardından yapılandırma dosyasını Azure Dosyalar'da oluşturulan bir dosya paylaşımına yükleyin. Bu dosya paylaşımı sonunda son kapsayıcıya birim olarak bağlanır.

Azure portalında (https://portal.azure.com ) oturum açın.
Yeni bir kaynak grubu oluşturun. Bu kılavuzdaki tüm yeni kaynaklar için bu kaynak grubunu kullanacaksınız.

Tavsiye

Kaynak grubunu msdocs-dab-aci olarak adlandırmanızı öneririz. Bu kılavuzdaki tüm ekran görüntüleri bu adı kullanır.

Bir Azure Depolama hesabı oluşturun. Hesabı yapılandırmak için bu ayarları kullanın.

Ayarlar	Değer
Kaynak Grubu	Daha önce oluşturduğunuz kaynak grubunu seçin
Depolama hesabı adı	Genel olarak benzersiz bir ad girin
Region	Bir Azure bölgesi seçin
Performans	Standart'ı seçin
Yedeklilik	Yerel olarak yedekli depolama (LRS) seçeneğini belirleyin
Depolama hesabı anahtarı erişimini etkinleştirme	Etkin seçin

Azure portalında 'Depolama hesabı oluştur' sayfasının 'Gelişmiş' sekmesinin ekran görüntüsü.

Azure portalında yeni depolama hesabına gidin.
Kaynak menüsünün Veri depolama bölümünde Dosya paylaşımları'nı seçin. Ardından, depolama hesabında yeni bir paylaşım oluşturmak için komut çubuğundan Dosya paylaşımı'nı seçin. Yeni dosya paylaşımını yapılandırmak için aşağıdaki ayarları kullanın.

Ayarlar Değer

İsim config'yi girin

Erişim katmanı Sıcak'ı seçin

Yedeklemeyi etkinleştirme Seçme
dab-config.json ve diğer gerekli dosyaları paylaşıma yükleyin. Dosyaları karşıya yükle iletişim kutusunu açmak için komut çubuğundaki Karşıya Yükle seçeneğini kullanın. Her iki dosyayı da seçin ve ardından Karşıya Yükle'yi seçin.
Kaynak menüsünün Güvenlik + ağ bölümünde Erişim anahtarları'nı seçin. Ardından bu sayfadan Depolama hesabı adı ve Anahtar değerlerini not edin. Bu değerleri bu kılavuzun ilerleyen bölümlerinde kullanacaksınız.

Ayarlar	Değer
İsim	`config`'yi girin
Erişim katmanı	Sıcak'ı seçin
Yedeklemeyi etkinleştirme	Seçme

Temel kapsayıcı örneğini oluşturun

Son olarak Azure Container Instances kullanarak Azure'da kapsayıcıyı oluşturun. Bu kapsayıcı, veritabanınıza bağlanmak için bir yapılandırma dosyası içeren Data API builder görüntüsünü barındırır.

Önemli

Bugün, bağlı bir birime sahip bir kapsayıcı örneği oluşturmanın tek yolu Azure CLI'dır.

kullanarak az container createbir Azure Container Instances kaynağı oluşturun. Kaynağı yapılandırmak için bu ayarları kullanın.

Ayarlar	Değer
Kaynak Grubu	Daha önce oluşturduğunuz kaynak grubunu kullanın
Kapsayıcı adı	Genel olarak benzersiz bir ad girin
Region	Depolama hesabıyla aynı bölgeyi kullanma
SKU	Standart Kullan
Görüntü türü	Genel kullan
Image	`mcr.microsoft.com/azure-databases/data-api-builder:latest`'yi girin
İşletim Sistemi Türü	Linux kullanma
Ağ türü	Genel kullan
Ağ bağlantı noktaları	`5000`'yi girin
DNS ad etiketi	Genel olarak benzersiz bir etiket girin
Ortam değişkenleri	Veritabanınızın bağlantı dizesini girin `DATABASE_CONNECTION_STRING` .

az container create \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --image "mcr.microsoft.com/azure-databases/data-api-builder:latest" \
    --location "<region>" \
    --sku "Standard" \
    --os-type "Linux" \
    --ip-address "public" \
    --ports "5000" \
    --dns-name-label "<unique-dns-label>" \
    --environment-variables "DATABASE_CONNECTION_STRING=<database-connection-string>" \
    --azure-file-volume-mount-path "/cfg" \
    --azure-file-volume-account-name "<storage-account-name>" \
    --azure-file-volume-account-key "<storage-account-key>" \
    --azure-file-volume-share-name "config" \
    --command-line "dotnet Azure.DataApiBuilder.Service.dll --ConfigFileName /cfg/dab-config.json"
    --

Tavsiye

Yetkilendirme anahtarları içermeyen bir bağlantı dizesi kullanmanızı öneririz. Bunun yerine, veritabanınız ve konağınız arasındaki erişimi yönetmek için yönetilen kimlikleri ve rol tabanlı erişim denetimini kullanın. Daha fazla bilgi için bkz. Yönetilen kimlikleri kullanan Azure hizmetleri.

az container show yeni kapsayıcı örneğinizin tam etki alanı adını (FQDN) sorgulamak için kullanın. Ardından kapsayıcı örneğinin web sitesine göz atın.

az container show \
    --resource-group "<resource-group-name>" \
    --name "<unique-container-instance-name>" \
    --query "join('://', ['https', ipAddress.fqdn])" \
    --output "tsv"

DAB kapsayıcısının çalıştığını ve durumunun iyi durumda olduğunu belirten yanıtı gözlemleyin.
```
{
    "status": "healthy",
    "version": "1.1.7",
    "app-name": "dab_oss_1.1.7"
}
```
Uyarı

Sürüm numarası ve adı, Veri API'sinin oluşturucusunun geçerli sürümüne göre değişir. Bu noktada, hiçbir API uç noktasına gidemezsiniz. Bu uç noktalar, BIR DAB yapılandırma dosyası bağladığınızda kullanılabilir.
Geçerli çalışan uygulamanın yoluna /api/swagger gidin. Varlıklarınızdan biri için HTTP GET isteği göndermek için Swagger kullanıcı arabirimini kullanın.

Kaynakları temizle

Örnek uygulamaya veya kaynaklara artık ihtiyacınız kalmadığında, ilgili dağıtımı ve tüm kaynakları kaldırın.

Azure portalını kullanarak kaynak grubuna gidin.
Komut çubuğundaSil'i seçin.

Sonraki adım

Application Insights ile tümleştirme

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-07-17