Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makalede, seçtiğiniz programlama dilinde 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 upgrade komutunu çalıştırın:
az upgrade
Ardından CLI için Container Apps uzantısını yükleyin veya güncelleştirin:
az extension add --name containerapp --upgrade --allow-preview true
Artık geçerli uzantı yüklendiğine göre, Microsoft.App ve Microsoft.OperationalInsights ad alanlarını kaydedin:
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ı oluştur ve dağıt.
İ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
komutunu kullanarak ilk kapsayıcı uygulamanızı derleyin ve dağıtın containerapp up . Bu komut:
- Kaynak grubunu oluşturur.
- Kapsayıcı Kayıt Defteri kaynağı 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.
- Kapsayıcı uygulamasını, yerleşik kapsayıcı görüntüsünü kullanarak oluşturur ve dağıtır.
Komut, 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 containerapp up çalıştırılmasını söyler.
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 gerekli izinlerle oturum açın az login --scope https://graph.microsoft.com//.default ve ardından komutu yeniden çalıştırın az containerapp up .
Dağıtımı doğrulayın
Kapsayıcı uygulamanın URL'sini, az containerapp up komutunun çıktısında 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ükleme boyutu üst sınırı 200 MB'tır. Dosya yükleme çok büyükse, hata 413 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ım
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.