Hızlı Başlangıç: Azure Container Apps'te Azure Uygulaması Yapılandırması'nı kullanma

Bu hızlı başlangıçta, Azure Container Apps'te çalışan bir uygulamada Azure Uygulaması Yapılandırması'nı kullanacaksınız. Bu şekilde, Container Apps'te uygulamalarınızın yapılandırmasının depolama ve yönetimini merkezi hale getirebilirsiniz. Bu hızlı başlangıç, Hızlı Başlangıç: Uygulama Yapılandırması ile ASP.NET Core uygulaması oluşturma bölümünde oluşturulan ASP.NET Core uygulamasından yararlanıyor. Uygulamayı kapsayıcıya alır ve Azure Container Apps'e dağıtırsınız. Devam etmeden önce hızlı başlangıcı tamamlayın.

Tavsiye

Bu hızlı başlangıcı takip ederken, tercihen tüm yeni kaynakları tek bir kaynak grubuna kaydedin; böylece daha sonra ihtiyacınız yoksa hepsini tek bir yerde yeniden gruplandırabilir ve daha sonra daha hızlı silebilirsiniz.

Önemli

Azure Container Apps'te Hizmet Bağlayıcısı (önizleme) desteği 30 Mart 2026'da sona eriyor. Bu tarihten sonra, Hizmet Bağlayıcısı (önizleme) kullanan yeni hizmet bağlantıları hiçbir arabirim üzerinden kullanılamaz. Daha fazla bilgi için AZURE Container Apps'te HİZMET BAĞLAYICISI (Önizleme) KULLANIMDAN KALDIRMA belgesine bakın.

Önkoşullar

Bir uygulama yapılandırma deposu kullanan bir uygulama. Eğer yoksa, Uygulama Yapılandırması ile ASP.NET Core uygulaması oluşturma - Hızlı Başlangıç kılavuzunu kullanarak bir örnek oluşturun.
Azure Container Apps örneği. Uygulamanız yoksa Azure portalını veya CLI'yı kullanarak bir örnek oluşturun.
Docker Desktop
Azure CLI

Azure Uygulaması Yapılandırması'nı kapsayıcı uygulamasına bağlama

Azure portalında Container App örneğine gidin.
Azure Container Apps için Hizmet Bağlayıcısı hızlı başlangıcını izleyerek aşağıdaki ayarları kullanarak Uygulama Yapılandırması deponuz için bir hizmet bağlantısı oluşturun.
1. Temel Bilgiler sekmesinde:
  - Hizmet türü altında, Uygulama Yapılandırması seçin
  - Uygulama Yapılandırması altında Uygulama Yapılandırması mağazanızı seçin.
2. Kimlik Doğrulaması sekmesinde:
  - Sistem tarafından atanan yönetilen kimlik kimlik doğrulama türünü seçin
  - Gelişmiş menüsünü genişletme
  - Kimliğinize Uygulama Yapılandırması Veri Okuyucusu rolünü atama
  - Yapılandırma bilgileri altında adlı AZURE_APPCONFIGURATION_ENDPOINTbir ortam değişkeni bulursunuz. Sağ taraftaki kalem simgesini seçin ve ortam değişkeni adını, uygulamanızda Uygulama Yapılandırması uç noktanızı yükleyebileceğiniz değişken adıyla eşleşecek şekilde düzenleyin. Eğer uygulamanızı ASP.NET Core hızlı başlangıç talimatlarına göre oluşturduysanız, değişken isminiz Endpoints:AppConfiguration. Değişken adını düzenlerken, iki noktayı çift alt çizgi ile değiştirerek Endpoints__AppConfiguration haline getirin. Başka bir uygulamayla çalışıyorsanız ilgili ortam değişkeni adını girin ve Bitti'yi seçin.
3. Diğer her şey için varsayılan değerleri kullanın.
Bağlantı oluşturulduğunda, Kapsayıcı Uygulaması kaynağınızın kapsayıcısına adlı Endpoints__AppConfiguration bir ortam değişkeni eklenir. Değer, Uygulama Yapılandırma deponuzun erişim noktası olan Container App'in gizli anahtarının bir referansıdır.

Kapsayıcı oluştur

dotnet publish komutunu çalıştırarak uygulamayı yayın sürümü modunda derleyin ve published klasöründe varlıkları oluşturun.
```
dotnet publish -c Release -o published
```
.csproj dosyanızı içeren dizinde Dockerfile adlı bir dosya oluşturun, dosyayı bir metin düzenleyicisinde açın ve aşağıdaki içeriği girin. Dockerfile, uzantısı olmayan ve kapsayıcı görüntüsü oluşturmak için kullanılan bir metin dosyasıdır.
```
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY published/ ./
ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
```
Aşağıdaki komutu çalıştırarak kapsayıcıyı oluşturun.
```
docker build --tag aspnetapp .
```

Azure Container Registry örneği oluşturacaksınız

Azure Container Registry (ACR) oluşturma. ACR, kapsayıcı görüntülerini oluşturmanızı, depolamanızı ve yönetmenizi sağlar.

Portal
Azure CLI

Kapsayıcı kayıt defterini oluşturmak için Azure Container Registry hızlı başlangıç kılavuzunu izleyin.
Dağıtım tamamlandıktan sonra ACR örneğinizi açın ve sol menüden Ayarlar > Erişim anahtarları'nı seçin.
Bu sayfada listelenen Oturum açma sunucusu değerini not edin. Bu bilgileri sonraki bir adımda kullanacaksınız.
Yönetici kullanıcısını Etkin olarak değiştirin. Bu seçenek, yönetici kullanıcı kimlik bilgilerini kullanarak ACR'yi Azure Container Apps'e bağlamanıza olanak tanır. Alternatif olarak, bunu devre dışı bırakabilir ve kapsayıcı uygulamasını yönetilen kimlikle kayıt defterinden görüntü çekecek şekilde yapılandırabilirsiniz.

Aşağıdaki komutu kullanarak bir ACR örneği oluşturun. Yönetici kullanıcı etkinleştirilmiş olan ve kapsayıcı uygulamasının yönetici kullanıcı kimlik bilgilerini kullanarak kayıt defterine bağlanmasına olanak tanıyan temel bir katman kayıt defteri myregistry adını taşır. Daha fazla bilgi için bkz. Azure Container Registry hızlı başlangıcı.
```
az acr create 
--resource-group AppConfigTestResources \
--name myregistry \
--admin-enabled true \
--sku Basic
```
Komut çıkışında, sonrasında loginServerlistelenen ACR oturum açma sunucusu değerini not alın.
komutunu çalıştırarak az acr credential show --name myregistryACR kullanıcı adını ve parolasını alın. Bu değerlere daha sonra ihtiyacınız olacak.

Görüntüyü Azure Container Registry'ye gönderme

Docker görüntüsünü daha önce oluşturulan ACR'ye gönderin.

Kayıt defterinde oturum açmak için az acr login komutunu çalıştırın.
```
az acr login --name myregistry
```
Oturum açma işlemi başarılı olduktan sonra komut döndürülüyor Login Succeeded .
Görüntüye uygun ayrıntıları etiketlemek için docker etiketini kullanın.
```
docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
```
Tavsiye

Mevcut docker görüntülerinizin ve etiketlerinizin listesini gözden geçirmek için komutunu çalıştırın docker image ls. Bu senaryoda en az iki görüntü görmeniz gerekir: aspnetapp ve myregistry.azurecr.io/aspnetapp.
Görüntüyü kapsayıcı kayıt defterine göndermek için docker push komutunu kullanın. Bu örnek, görüntüyü içeren ACR'de aspnetapp. Aşağıdaki örnekte yer tutucularını <login-server<image-name> ve <tag> ACR'nin oturum açma sunucusu değerini, görüntü adını ve görüntü etiketini değiştirin.

Yöntem:
```
docker push <login-server>/<image-name>:<tag>
```
Örnek:
```
docker push myregistry.azurecr.io/aspnetapp:v1
```
Azure portalda Azure Container Registry'nizi açın ve Depolar'ın altında yeni deponuzu görebildiğinizi onaylayın.

Kapsayıcı görüntünüzü Azure Container Apps'e ekleme

Kapsayıcı Uygulamanızı, kapsayıcı görüntüsünü ACR'nizden yükleyecek şekilde güncelleyin.

Azure portalında Azure Container Apps örneğinizi açın.
Soldaki menüde, Uygulama'nın altında Kapsayıcılar'ı seçin.
Düzenle ve dağıt'ı seçin.
Kapsayıcı görüntüsü altında, mevcut kapsayıcı görüntüsünün adına tıklayın.

Aşağıdaki ayarları güncelleştirin:

Setting	Önerilen değer	Description
Görüntü kaynağı	Azure Container Registry	Görüntü kaynağınız olarak Azure Container Registry'yi seçin.
Authentication	Yönetici Kimlik Bilgileri	Kapsayıcı kayıt defterinde daha önce etkinleştirilen yönetici kullanıcı kimlik bilgisi seçeneğini kullanın. Yönetici kullanıcıyı etkinleştirmediyseniz ancak yönetilen kimlik kullanacak şekilde yapılandırdıysanız, görüntüyü ve etiketi forma el ile girmeniz gerekir.
Registry	myregistry.azurecr.io	Daha önce oluşturduğunuz Azure Container Registry'yi seçin.
Resim	aspnetapp	Daha önce oluşturduğunuz ve ACR'ye gönderilen docker görüntüsünü seçin.
Resim etiketi	v1	Listeden görüntü etiketinizi seçin.

Güncelleştirmeyi Azure Container App'e dağıtmak için Kaydet'i ve ardından Oluştur'u seçin.

Azure Container App'in URL'sine göz atın

Azure portalında, Azure Container Apps örneğinde Genel Bakış sekmesine gidin ve Uygulama Url'sini açın.

Web sayfası şöyle görünür:

Uygulamayı çalıştıran bir internet tarayıcısının ekran görüntüsü.

Kaynakları temizle

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız ücretlerden kaçınmak için burada oluşturduğunuz kaynak grubunu silin.

Önemli

Bir kaynak grubunu silmek geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu makalenin kaynaklarını, saklamak istediğiniz diğer kaynakları içeren bir kaynak grubu içinde oluşturduysanız, kaynak grubunu silmek yerine her kaynağı ilgili bölmeden tek tek silin.

Azure portalında oturum açın ve Kaynak grupları'nı seçin.
Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
Kaynak grubunu sil seçeneğini seçin.
Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil'i seçin.

Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.

Bu hızlı başlangıç rehberinde şunları yapacaksınız:

Azure App Configuration'u Azure Container Apps'e bağladı.
docker kullanarak ASP.NET Core uygulamasından Uygulama Yapılandırması ayarlarıyla kapsayıcı görüntüsü oluşturma
Azure Container Registry örneği oluşturma
Görüntüyü Azure Container Registry örneğine gönderme
Azure Container Apps'e kapsayıcı görüntüsü eklendi
Uygulama Yapılandırması deponuzda yapılandırdığınız ayarlarla güncellenmiş Azure Container Apps örneğinin URL'sine gidin.

Yönetilen kimlik, gizli bilgileri yönetmeden bir Azure kaynağının diğerine erişmesini sağlar. Container Apps'ten diğer Azure kaynaklarına erişimi kolaylaştırabilirsiniz. Daha fazla bilgi için, bkz. yönetilen kimliği kullanarak App Configuration'a erişme ve yönetilen kimliği kullanarak Container Registry'ye erişme.

ASP.NET Core web uygulamanızı yapılandırma ayarlarını dinamik olarak yenilemek üzere yapılandırmayı öğrenmek için sonraki öğreticiye geçin.

Dinamik yapılandırmayı etkinleştirme

Last updated on 2025-09-19

Aracılığıyla paylaş