Hızlı Başlangıç: Azure Container Apps'e yapıt dosyası dağıtma (önizleme)

Bu hızlı başlangıçta, önceden oluşturulmuş bir yapıt dosyasından kapsayıcı uygulaması dağıtmayı öğreneceksiniz. Bu makaledeki örnek, Java'ya özgü bir bildirim dosyası içeren BIR JAR dosyası kullanarak bir Java uygulaması dağıtır. İşiniz, statik bir müzik albümleri koleksiyonu döndüren bir arka uç web API'si hizmeti oluşturmaktır. Bu hızlı başlangıcı tamamladıktan sonra, API'yi çağıran bir ön uç uygulamasının nasıl dağıtıldığını öğrenmek için mikro hizmetler arasındaki iletişim bölümüne devam edebilirsiniz.

Aşağıdaki ekran görüntüsünde dağıttığınız albüm API'sinin çıkışı gösterilmektedir.

Önkoşullar

Ayarlama

CLI'dan Azure'da oturum açmak için aşağıdaki komutu çalıştırın ve istemleri izleyerek kimlik doğrulama işlemini tamamlayın.

az login

Connect-AzAccount

CLI'nın en son sürümünü çalıştırdığınızdan emin olmak için yükseltme komutunu çalıştırın.

az upgrade

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Ardından CLI için Azure Container Apps uzantısını yükleyin veya güncelleştirin.

Azure CLI'da komutları veya Azure PowerShell'deki modülden Az.App cmdlet'leri çalıştırdığınızda az containerapp eksik parametrelerle ilgili hatalar alırsanız, Azure Container Apps uzantısının en son sürümünü yüklediğinizden emin olun.

az extension add --name containerapp --upgrade

az extension add --name containerapp --upgrade --allow-preview true

Install-Module -Name Az.App

Update-Module -Name Az.App

Geçerli uzantı veya modül yüklendikten sonra ve Microsoft.OperationalInsights ad alanlarını kaydedinMicrosoft.App.

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Ortam değişkenlerini oluşturma

Azure CLI kurulumunuz tamamlandıktan sonra bu makalenin tamamında kullanılan ortam değişkenlerini tanımlayabilirsiniz.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

az account list --output table

$RESOURCE_GROUP="album-containerapps"
$LOCATION="canadacentral"
$ENVIRONMENT="env-album-containerapps"
$API_NAME="album-api"
$SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

az account list --output table

GitHub deposunu hazırlama

Örnek depoyu kopyalayarak başlayın.

Örnek uygulamayı koddan buluta klasörüne kopyalamak için aşağıdaki git komutunu kullanın:

git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud

cd code-to-cloud

JAR dosyası oluşturma

Projeyi Maven ile oluşturun.

mvn clean package -DskipTests

mvn clean package -DskipTests

Projeyi yerel olarak çalıştırma

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

Uygulamanın çalıştığını doğrulamak için bir tarayıcı açın ve adresine http://localhost:8080/albumsgidin. Sayfa, JSON nesnelerinin listesini döndürür.

Yapıtı dağıtma

komutuyla yerel JAR dosyanızdan ilk kapsayıcı uygulamanızı derleyin ve dağıtın containerapp up .

Şu komut:

• Kaynak grubunu oluşturur
• Azure Container Registry oluşturur
• Kapsayıcı görüntüsünü oluşturur ve kayıt defterine gönderir
• Log Analytics çalışma alanıyla Container Apps ortamını oluşturur
• Genel kapsayıcı görüntüsü kullanarak kapsayıcı uygulamasını oluşturur ve dağıtır

komutu, up kapsayıcı görüntüsünü oluşturmak için deponun kökündeki Docker dosyasını kullanır. EXPOSE Docker dosyasındaki yönerge hedef bağlantı noktasını tanımlar. Ancak kapsayıcı uygulaması oluşturmak için Docker dosyası gerekmez.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
  --ingress external \
  --target-port 8080 \
  --subscription $SUBSCRIPTION

az containerapp up `
    --name $API_NAME `
    --resource-group $RESOURCE_GROUP `
    --location $LOCATION `
    --environment $ENVIRONMENT `
    --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar `
    --ingress external `
    --target-port 8080 `
    --subscription $SUBSCRIPTION

Dağıtımı doğrulama

FQDN'yi bir web tarayıcısına kopyalayın. Web tarayıcınızdan FQDN'nin uç noktasına gidin /albums .

WAR dosyası dağıtma

Kapsayıcı uygulamanızı war dosyasından da dağıtabilirsiniz.

Kaynakları temizleme

Bu uygulamayı kullanmaya devam etmeyecekseniz, kaynak grubunu kaldırarak Azure Container Apps örneğini ve ilişkili tüm hizmetleri silebilirsiniz.

Oluşturduğunuz kaynakları kaldırmak için şu adımları izleyin:

az group delete \
  --resource-group $RESOURCE_GROUP

az group delete `
  --resource-group $RESOURCE_GROUP

Sonraki adımlar