Azure Pipelines'tan Azure Container Apps'e dağıtma

Azure Container Apps, kapsayıcı uygulamanızda düzeltmeleri yayımlamak için Azure Pipelines'ı kullanmanıza olanak tanır. İşlemeler Azure DevOps deponuza gönderildiğinde, kapsayıcı kayıt defterindeki kapsayıcı görüntüsünü güncelleştiren bir işlem hattı tetiklenir. Azure Container Apps, güncelleştirilmiş kapsayıcı görüntüsünü temel alan yeni bir düzeltme oluşturur.

Deponuzdaki belirli bir dala yapılan işlemeler işlem hattını tetikler. İşlem hattını oluştururken tetikleyicinin hangi dal olduğuna siz karar verirsiniz.

Container Apps Azure Pipelines görevi

Görev aşağıdaki senaryoları destekler:

• Dockerfile'dan derleme ve Container Apps'e dağıtma
• Dockerfile olmadan kaynak koddan derleyin ve Container Apps'e dağıtın. Desteklenen diller .NET, Java, Node.js, PHP ve Python'dır
• Mevcut kapsayıcı görüntüsünü Container Apps'e dağıtma

Üretim sürümüyle birlikte bu görev Azure DevOps ile birlikte gelir ve artık açık yükleme gerektirmez. Tüm belgeler için bkz . AzureContainerApps@1 - Azure Container Apps Dağıtma v1 görevi.

Kullanım örnekleri

Burada, görevi kullanmaya yönelik bazı yaygın senaryolar yer alır. Daha fazla bilgi için görevin belgelerine bakın.

Container Apps'i derleme ve dağıtma

Aşağıdaki kod parçacığında kaynak koddan bir kapsayıcı görüntüsünün nasıl derlenip Container Apps'e nasıl dağıtılacağı gösterilmektedir.

YAML

steps:
- task: AzureContainerApps@1
  inputs:
    appSourcePath: '$(Build.SourcesDirectory)/src'
    azureSubscription: 'my-subscription-service-connection'
    acrName: 'myregistry'
    containerAppName: 'my-container-app'
    resourceGroup: 'my-container-app-rg'

Görev, kapsayıcı görüntüsünü oluşturmak için içindeki appSourcePath Dockerfile dosyasını kullanır. Dockerfile bulunamazsa, görev içindeki appSourcePathkaynak kodundan kapsayıcı görüntüsünü oluşturmaya çalışır.

Mevcut kapsayıcı görüntüsünü Container Apps'e dağıtma

Aşağıdaki kod parçacığında, mevcut bir kapsayıcı görüntüsünün Container Apps'e nasıl dağıtılacağı gösterilmektedir. Görev, hizmet bağlantısını kullanarak kayıt defterinde kimlik doğrulaması yapar. Hizmet bağlantısının kimliğine kayıt defteri rolü atanmamışsa AcrPush ve acrPassword giriş parametrelerini kullanarak kayıt defterinin acrUsername yönetici kimlik bilgilerini sağlayın.

YAML

steps:
  - task: AzureContainerApps@1
    inputs:
      azureSubscription: 'my-subscription-service-connection'
      containerAppName: 'my-container-app'
      resourceGroup: 'my-container-app-rg'
      imageToDeploy: 'myregistry.azurecr.io/my-container-app:$(Build.BuildId)'

Önemli

Ayrı bir adımda kapsayıcı görüntüsü oluşturuyorsanız gibi latestkararlı bir etiket yerine derleme kimliği gibi benzersiz bir etiket kullandığınızdan emin olun. Daha fazla bilgi için bkz . Görüntü etiketi en iyi yöntemleri.

Azure Container Registry ile kimlik doğrulaması

Kapsayıcı görüntüsünü göndermek için Azure Container Apps görevinin Azure Container Registry ile kimlik doğrulaması yapması gerekir. Kapsayıcı uygulamasının kapsayıcı görüntüsünü çekmek için Azure Container Registry'nizle de kimlik doğrulaması yapması gerekir.

Görüntüleri göndermek için, görev içinde sağlanan azureSubscriptionhizmet bağlantısını kullanarak içinde acrName belirtilen kapsayıcı kayıt defteriyle otomatik olarak kimlik doğrulaması yapar. Hizmet bağlantısının kimliğine kayıt defteri rolü atanmamışsa AcrPush ve acrPasswordkullanarak acrUsername kayıt defterinin yönetici kimlik bilgilerini sağlayın.

Görüntüleri çekmek için Azure Container Apps, Azure Container Registry ile kimlik doğrulaması yapmak için yönetilen kimlik (önerilen) veya yönetici kimlik bilgilerini kullanır. Yönetilen kimliği kullanmak için görevin hedef kapsayıcı uygulamasının yönetilen kimliği kullanacak şekilde yapılandırılması gerekir. Kayıt defterinin yönetici kimlik bilgileriyle kimlik doğrulaması yapmak için görevin acrUsername ve acrPassword girişlerini ayarlayın.

Yapılandırma

Azure Container Apps'e dağıtmak üzere bir Azure DevOps işlem hattı yapılandırmak için aşağıdaki adımları uygulayın.

• Uygulamanız için Azure DevOps deposu oluşturma
• Yönetilen kimlik etkin bir kapsayıcı uygulaması oluşturma
• AcrPull Azure Container Registry rolünü kapsayıcı uygulamasının yönetilen kimliğine atama
• Azure DevOps Market'ten Azure Container Apps görevini yükleme
• Azure aboneliğiniz için Azure DevOps hizmet bağlantısı yapılandırma
• Azure DevOps işlem hattı oluşturma

Önkoşullar

Gereksinim	Yönergeler
Azure hesabı	Hesabınız yoksa ücretsiz bir hesap oluşturun. Devam etmek için Azure aboneliğinde Katkıda Bulunan veya Sahip iznine sahip olmanız gerekir. Ayrıntılar için Bkz. Azure portalını kullanarak Azure rolleri atama.
Azure DevOps projesi	Azure DevOps'a gidin ve Ücretsiz başlat'ı seçin. Ardından yeni bir proje oluşturun.
Azure CLI	Azure CLI’yi yükleyin.

Azure DevOps deposu oluşturma ve kaynak kodu kopyalama

İşlem hattı oluşturmadan önce uygulamanızın kaynak kodu bir depoda olmalıdır.

1. Azure DevOps'ta oturum açın ve projenize gidin.

2. Depolar sayfasını açın.

3. Üst gezinti çubuğunda depolar açılan listesini ve ardından Depoyu içeri aktar'ı seçin.

4. Aşağıdaki bilgileri girin ve İçeri Aktar'ı seçin:

   Alan	Değer
   Depo türü	Git
   URL'yi kopyalama	https://github.com/Azure-Samples/containerapps-albumapi-csharp.git
   Ad	my-container-app

5. Depo URL'sini görüntülemek ve kopyalamak için Kopyala'yı seçin.

6. Bir terminal açın ve aşağıdaki komutu çalıştırın:

   Bash

   git clone <REPOSITORY_URL> my-container-app
   

   değerini kopyaladığınız URL ile değiştirin <REPOSITORY_URL> .

Kapsayıcı uygulaması oluşturma ve yönetilen kimliği yapılandırma

Aşağıdaki adımlarla komutunu kullanarak az containerapp up kapsayıcı uygulamanızı oluşturun. Bu komut Azure kaynaklarını oluşturur, kapsayıcı görüntüsünü oluşturur, görüntüyü bir kayıt defterinde depolar ve bir kapsayıcı uygulamasına dağıtır.

Uygulamanız oluşturulduktan sonra, uygulamanıza bir yönetilen kimlik ekleyebilir ve kimliğin AcrPull kayıt defterinden görüntü çekmesine izin vermek için bu kimliği atayabilirsiniz.

1. Kopyalanan deponun src klasörüne geçin.

   Bash

   cd my-container-app
   cd src
   

2. Komutuyla Azure kaynakları oluşturun ve bir kapsayıcı uygulaması dağıtın.az containerapp up

   Azure CLI

   az containerapp up \
     --name my-container-app \
     --source . \
     --ingress external 
   

3. Komut çıkışında Azure Container Registry'nin adını not edin.

4. Kapsayıcı kayıt defterinin tam kaynak kimliğini alın.

   Azure CLI

   az acr show --name <ACR_NAME> --query id --output tsv
   

   <ACR_NAME> değerini kayıt defterinizin adıyla değiştirin.

5. Kapsayıcı uygulaması için yönetilen kimliği etkinleştirin.

   Azure CLI

   az containerapp identity assign \
     --name my-container-app \
     --resource-group my-container-app-rg \
     --system-assigned
   

   Komut çıkışında yönetilen kimliğin asıl kimliğini not edin.

6. AcrPull Azure Container Registry rolünü kapsayıcı uygulamasının yönetilen kimliğine atayın.

   Azure CLI

   az role assignment create \
     --assignee <MANAGED_IDENTITY_PRINCIPAL_ID> \
     --role AcrPull \
     --scope <ACR_RESOURCE_ID>
   

   değerini yönetilen kimliğin asıl kimliğiyle ve <ACR_RESOURCE_ID> Azure Container Registry'nin kaynak kimliğiyle değiştirin<MANAGED_IDENTITY_PRINCIPAL_ID>.

7. Azure Container Registry'den görüntü çekmek için kapsayıcı uygulamasını yönetilen kimliği kullanacak şekilde yapılandırın.

   Azure CLI

   az containerapp registry set \
     --name my-container-app \
     --resource-group my-container-app-rg \
     --server <ACR_NAME>.azurecr.io \
     --identity system
   

   değerini Azure Container Registry'nizin adıyla değiştirin <ACR_NAME> .

Azure DevOps hizmet bağlantısı oluşturma

Azure Container Apps'e dağıtmak için Azure aboneliğiniz için bir Azure DevOps hizmet bağlantısı oluşturmanız gerekir.

1. Azure DevOps'ta Proje ayarları'nı seçin.

2. Hizmet bağlantıları'nı seçin.

3. Yeni hizmet bağlantısı'nı seçin.

4. Azure Resource Manager'ı seçin.

5. Hizmet sorumlusu (otomatik) öğesini ve ardından İleri'yi seçin.

6. Aşağıdaki bilgileri girin ve Kaydet'i seçin:

   Alan	Değer
   Abonelik	Azure aboneliği seçin.
   Kaynak grubu	Kapsayıcı uygulamanızı ve kapsayıcı kayıt defterinizi içeren kaynak grubunu (my-container-app-rg) seçin.
   Hizmet bağlantısı adı	my-subscription-service-connection

Hizmet bağlantıları hakkında daha fazla bilgi edinmek için bkz . Microsoft Azure'a bağlanma.

Azure DevOps YAML işlem hattı oluşturma

1. Azure DevOps projenizde İşlem Hatları'yı seçin.

2. Yeni işlem hattı'ni seçin.

3. Azure Repos Git'i seçin.

4. Kaynak kodunuzu (my-container-app) içeren depoyu seçin.

5. Başlangıç işlem hattı'ı seçin.

6. Düzenleyicide dosyanın içeriğini aşağıdaki YAML ile değiştirin:

   YAML

   trigger:
     branches:
       include:
         - main
   
   pool:
     vmImage: ubuntu-latest
   
   steps:
     - task: AzureContainerApps@1
       inputs:
         appSourcePath: '$(Build.SourcesDirectory)/src'
         azureSubscription: '<AZURE_SUBSCRIPTION_SERVICE_CONNECTION>'
         acrName: '<ACR_NAME>'
         containerAppName: 'my-container-app'
         resourceGroup: 'my-container-app-rg'
   

   değerini önceki adımda oluşturduğunuz Azure DevOps hizmet bağlantısının (my-subscription-service-connection) adıyla ve <ACR_NAME> Azure Container Registry'nizin adıyla değiştirin<AZURE_SUBSCRIPTION_SERVICE_CONNECTION>.

7. Kaydet ve çalıştır'ı seçin.

Azure Pipelines çalıştırması kapsayıcı uygulamanızı derlemeye ve dağıtmaya başlar. İlerleme durumunu denetlemek için İşlem Hatları'na gidin ve çalıştırmayı seçin. İlk işlem hattı çalıştırması sırasında işlem hattına hizmet bağlantınızı kullanma yetkisi vermeniz istenebilir.

Uygulamanızın yeni bir düzeltmesini dağıtmak için ana dala yeni bir işleme gönderin.