Hızlı Başlangıç: Yerel kaynak kodu derleme ve Azure Container Apps'e dağıtma
Bu makalede, seçtiğiniz programlama dilini kullanarak yerel kaynak kodundan Azure Container Apps'e mikro hizmet oluşturma ve dağıtma işlemleri gösterilmektedir. Bu hızlı başlangıçta, statik bir müzik albümleri koleksiyonu döndüren bir arka uç web API'si hizmeti oluşturacaksınız.
Aşağıdaki ekran görüntüsünde dağıttığınız albüm API'sinin çıkışı gösterilmektedir.
Önkoşullar
Bu projeyi tamamlamak için aşağıdaki öğeler gerekir:
| 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. |
| Git | Git'i yükleyin. |
| Azure CLI | Azure CLI’yi yükleyin. |
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
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
Ardından CLI için Azure Container Apps uzantısını yükleyin veya güncelleştirin.
az extension add --name containerapp --upgrade --allow-preview true
Geçerli uzantı yüklendikten sonra ve Microsoft.OperationalInsights ad alanlarını kaydedinMicrosoft.App.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Ortam değişkenlerini oluşturma
CLI kurulumunuz tamamlandıktan sonra, bu makalenin tamamında kullanılan ortam değişkenlerini tanımlayabilirsiniz.
Bash kabuğunuzda aşağıdaki değişkenleri tanımlayın.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
Örnek kodunu alma
Örnek uygulamayı istediğiniz dilde kopyalamak ve proje kaynak klasörüne geçmek için aşağıdaki komutu çalıştırın.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
Kapsayıcı uygulamasını derleme ve dağıtma
İlk olarak, bu hızlı başlangıçta oluşturduğunuz kaynakları içerecek kaynak grubunu oluşturmak için aşağıdaki komutu çalıştırın.
az group create --name $RESOURCE_GROUP --location $LOCATION
komutuyla ilk kapsayıcı uygulamanızı derleyin ve dağıtın containerapp up . Bu komut:
- Bir kaynak grubu oluştur
- Azure Container Registry oluşturma
- Kapsayıcı görüntüsünü oluşturma ve kayıt defterine gönderme
- Log Analytics çalışma alanıyla Container Apps ortamı oluşturma
- Yerleşik kapsayıcı görüntüsünü kullanarak kapsayıcı uygulamasını oluşturma ve dağıtma
komutu, up kapsayıcı görüntüsünü oluşturmak için proje klasöründeki Dockerfile dosyasını kullanır. EXPOSE Dockerfile içindeki yönerge, kapsayıcıya giriş trafiği göndermek için kullanılan bağlantı noktası olan hedef bağlantı noktasını tanımlar.
Aşağıdaki kod örneğinde . (nokta), dockerfile dosyasını da içeren projenin geçerli dizininde çalıştırılmasını söyler containerapp up .
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Not
Komut "AADSTS50158: Dış güvenlik sınaması karşılanmıyor" iletisiyle bir hata döndürürse komutunu çalıştırarak az login --scope https://graph.microsoft.com//.default gerekli izinlerle oturum açın ve komutu yeniden çalıştırın az containerapp up .
Dağıtımı doğrulama
Komutun çıkışında kapsayıcı uygulamasının URL'sini az containerapp up bulun. Tarayıcınızda URL'ye gidin. API'den gelen yanıtı görmek için URL'nin sonuna ekleyin /albums .
Sınırlar
Kaynak kodu karşıya yüklemek için en büyük boyut 200 MB'tır. Karşıya yükleme sınırı aşıyorsa 413 hatası döndürülür.
Kaynakları temizleme
Ön uç dağıtma öğreticisine devam etmeyecekseniz, aşağıdaki komutu kullanarak bu hızlı başlangıç sırasında oluşturulan Azure kaynaklarını kaldırabilirsiniz.
Dikkat
Aşağıdaki komut, belirtilen kaynak grubunu ve içindeki tüm kaynakları siler. Grup bu hızlı başlangıcın kapsamı dışında kaynaklar içeriyorsa, bunlar da silinir.
az group delete --name $RESOURCE_GROUP
İpucu
Sorun mu yaşıyorsunuz? Azure Container Apps deposunda bir sorun açarak GitHub'da bize bildirin.
Sonraki adımlar
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 Öğretici: Azure Container Apps'teki mikro hizmetler arasındaki iletişim bölümüne devam edebilirsiniz.