Aracılığıyla paylaş

Azure Container Apps'e Veri API oluşturucusu dağıtma

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

Önkoşullar

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.

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

  2. 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.

  3. 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:*"

  4. 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.

  1. Azure portalında (https://portal.azure.com ) oturum açın.

  2. Yeni bir kaynak grubu oluşturun. Bu kılavuzdaki tüm yeni kaynaklar için bu kaynak grubunu kullanacaksınız.

    Azure portalında 'Kaynak grubu oluştur' sayfasının 'Temel Bilgiler' sekmesinin ekran görüntüsü.

    Tavsiye

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

  3. 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
    Bölge 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'i seçin

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

  4. Azure portalında yeni depolama hesabına gidin.

  5. 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 tuşuna basın
    Erişim katmanı Sıcak'ı seçin
    Yedeklemeyi etkinleştirme Seçme

    Azure portalında **Dosya paylaşımı** kaynak menüsünün ve komut çubuğu seçeneklerinin ekran görüntüsü.

  6. 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.

    Azure portalında **Dosyaları karşıya yükle** iletişim kutusunun ekran görüntüsü.

  7. 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.

    Azure portalındaki bir depolama hesabı içindeki 'Erişim Anahtarları' sayfasının ekran görüntüsü.

Temel kapsayıcı uygulamasını oluşturma

Şimdi Azure Container Apps'i kullanarak Azure'da kapsayıcıyı oluşturun. Bu kapsayıcı, yapılandırma olmadan Veri API'sini oluşturucu görüntüsünü barındırır.

  1. Azure Container Apps kaynağı oluşturun. Uygulama kaynağını oluşturma işleminin bir parçası olarak bir ortam oluşturmanız gerekir. Her iki kaynağı da yapılandırmak için bu ayarları kullanın.

    Kaynak Ayarlar Değer
    Çevre Ortam adı Genel olarak benzersiz bir ad girin
    Çevre Ortam türü Yalnızca tüketim'i seçin
    Çevre Kayıtların hedefi Günlükleri kaydetmemeyi seçin
    Uygulama Kaynak Grubu Daha önce oluşturduğunuz kaynak grubunu seçin
    Uygulama Depolama hesabı adı Genel olarak benzersiz bir ad girin
    Uygulama Bölge Depolama hesabıyla aynı bölgeyi seçin
    Uygulama Hızlı başlangıç görüntüsünü kullanma Seçme
    Uygulama Görüntü kaynağı Docker Hub'ı veya diğer kayıt defterlerini seçin
    Uygulama Görüntü türü Genel’i seçin
    Uygulama Kayıt defteri oturum açma sunucusu mcr.microsoft.com tuşuna basın
    Uygulama Resim ve etiket azure-databases/data-api-builder:latest tuşuna basın
    Uygulama Ortam değişkenleri - Ad DATABASE_CONNECTION_STRING tuşuna basın
    Uygulama Ortam değişkenleri - Değer Veritabanınızın bağlantı dizesini girin.
    Uygulama Giriş Etkin'in seçili olduğundan emin olun
    Uygulama Giriş trafiği Her yerden trafiği kabul etme'yi seçin
    Uygulama İstemci sertifikası modu Yoksay seçin
    Uygulama Giriş türü HTTP'yi seçin
    Uygulama Hedef bağlantı noktası 5000 tuşuna basın

    Azure portalında 'Kapsayıcı Uygulaması Oluştur' sayfasının 'Kapsayıcı' sekmesinin ekran görüntüsü.

    Azure portalında 'Container Apps Ortamı Oluştur' sayfasının 'Temel Bilgiler' sekmesinin ekran görüntüsü.

    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.

  2. Azure portalında yeni kapsayıcı uygulamasına gidin.

  3. Kapsayıcı uygulamasının web sitesine göz atmak için Temel Bileşenler bölümündeki Uygulama URL'si alanını kullanın. 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.

Yapılandırma dosyalarını bağlama

Son olarak Azure Dosyalar paylaşımındaki yapılandırma dosyalarını kapsayıcı uygulamasına bağlayın. Bu adım, Veri API'sinin oluşturucusunun veritabanınıza bağlanmak için yapılandırma dosyasını kullanmasına olanak tanır.

  1. Azure portalını kullanarak bu kılavuzda daha önce oluşturulan kapsayıcı ortamına gidin.

  2. Kaynak menüsünün Ayarlar bölümünde Azure dosyaları'nı seçin. Ardından, kapsayıcı ortamına var olan bir dosya paylaşımını eklemek için komut çubuğundan Ekle'yi seçin. Yeni dosya paylaşımını yapılandırmak için aşağıdaki ayarları kullanın. Ardından yeni dosya paylaşımı yapılandırmasını kaydedin .

    Ayarlar Değer
    İsim config-share tuşuna basın
    Depolama hesabı adı Bu kılavuzun önceki bölümlerinde kaydedilen depolama hesabının adı.
    Depolama hesabı anahtarı Bu kılavuzun önceki bölümlerinde kaydedilen depolama hesabının anahtarı.
    Dosya paylaşımı config tuşuna basın
    Erişim modu "Sadece oku seçeneğini seçin"

    Azure portalındaki kaynak menüsündeki 'Azure Dosyaları' seçeneğinin ekran görüntüsü.

  3. Azure portalında kapsayıcı uygulamasına yeniden gidin.

  4. Kaynak menüsünün Uygulama bölümünde Düzeltmeler ve çoğaltmalar'ı seçin. Ardından, kapsayıcı uygulamanız için yeni bir düzeltme yapılandırma işlemini başlatmak için komut çubuğundan Yeni düzeltme oluştur'u seçin.

  5. Birimler bölümüne gidin ve Ekle seçeneğini belirleyin. Yeni birimi yapılandırmak için aşağıdaki ayarları kullanın. Birimi yapılandırdıktan sonra, kapsayıcı sürümüne ekleyin.

    Ayarlar Değer
    Birim türü Azure dosya birimi seç
    İsim config-volume tuşuna basın
    Dosya paylaşımı config tuşuna basın

    Azure portalındaki 'Yeni birim oluştur' bölümünün ekran görüntüsü.

  6. Kapsayıcı bölümüne gidin, geçerli tek kapsayıcıyı seçin ve ardından Düzenle seçeneğini belirleyin. Kapsayıcı için iki bağlama yapılandırmak için aşağıdaki ayarları kullanın. Değişikliklerinizi kaydedin.

    Ayarlar Değer
    Birim adı config-volume tuşuna basın
    Bağlama yolu /App/dab-config.json tuşuna basın
    Alt yol dab-config.json tuşuna basın
    Ayarlar Değer
    Birim adı config-volume tuşuna basın
    Bağlama yolu /App/schema.graphql tuşuna basın
    Alt yol schema.graphql tuşuna basın

    Azure portalındaki 'Birim bağlama ekleme' bölümünün ekran görüntüsü.

  7. Belirttiğiniz birim bağlamalarını kullanarak yeni bir düzeltme oluşturmak için Oluştur'u seçin. Düzeltmenin dağıtımının tamamlanmasını bekleyerek.

  8. Kapsayıcı uygulamasının web sitesine yeniden göz atmak için Temel Bileşenler bölümündeki Uygulama URL'si alanını kullanın. Yanıtın hala DAB kapsayıcısının iyi durumda olduğunu gösterdiğini gözlemleyin.

  9. 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ı temizleme

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

  1. Azure portalını kullanarak kaynak grubuna gidin.

  2. Komut çubuğundaSil'i seçin.

Sonraki adım

Application Insights ile tümleştirme

  • Last updated on