Yönetilen kimlikle Azure Container Apps görüntü çekme
Makale
Yönetici kimlik bilgilerinin kullanılmasını önlemek için kimlik doğrulaması için yönetilen kimlikleri kullanarak Microsoft Azure Container Registry'deki özel depolardan görüntü çekebilirsiniz.
Azure Container Registry ile kimlik doğrulaması yapmak için kullanıcı tarafından atanan veya sistem tarafından atanan yönetilen kimliği kullanabilirsiniz.
Kullanıcı tarafından atanan yönetilen kimlikle, kimliği Azure Container Apps dışında oluşturur ve yönetirsiniz. Azure Container Apps dahil olmak üzere birden çok Azure kaynağına atanabilir.
Sistem tarafından atanan yönetilen kimlik ile kimlik, Azure Container Apps tarafından oluşturulur ve yönetilir. Kapsayıcı uygulamanıza bağlıdır ve uygulamanız silindiğinde silinir.
Mümkün olduğunda, görüntüleri çekmek için kullanıcı tarafından atanan yönetilen kimliği kullanmanız gerekir.
Kapsayıcı Uygulamaları, kapsayıcı başlatıldığında görüntünün yeni bir sürümünü denetler. Docker veya Kubernetes terminolojisinde, Container Apps her kapsayıcının görüntü çekme ilkesini olarak alwaysayarlar.
Bu makalede, kapsayıcı uygulamanızı özel Azure Container Registry depolarından görüntü çekmek üzere kullanıcı tarafından atanan ve sistem tarafından atanan yönetilen kimlikleri kullanacak şekilde yapılandırmak için Azure portalının nasıl kullanılacağı açıklanmaktadır.
Kullanıcı tarafından atanan yönetilen kimlik
Aşağıdaki adımlar, kapsayıcı uygulamanızı özel Azure Container Registry depolarından görüntü çekmek için kullanıcı tarafından atanan yönetilen kimliği kullanacak şekilde yapılandırma işlemini açıklar.
Genel görüntü içeren bir kapsayıcı uygulaması oluşturun.
Kullanıcı tarafından atanan yönetilen kimliği kapsayıcı uygulamasına ekleyin.
Özel görüntü ve kullanıcı tarafından atanan yönetilen kimlikle bir kapsayıcı uygulaması düzeltmesi oluşturun.
Çekmek istediğiniz görüntüyü içeren özel bir Azure Container Registry.
Azure Container Registry'nizin görüntüleri çekmek için yönetilen kimliği kullanabilmesi için kimlik doğrulaması için ARM hedef kitle belirteçlerine izin vermesi gerekir.
ARM belirteçlerinin ACR'nize erişmesine izin verilip verilmediğini denetlemek için aşağıdaki komutu kullanın:
Azure CLI
az acr config authentication-as-arm show -r<REGISTRY>
ARM belirteçlerine izin verilmiyorsa, aşağıdaki komutla bunlara izin vekleyebilirsiniz:
Azure CLI
az acr config authentication-as-arm update -r<REGISTRY>--status enabled
Kapsayıcıyı düzenle iletişim kutusuna bilgileri girin.
Alan
Eylem
Ad
Kapsayıcı için bir ad girin.
Görüntü kaynağı
Azure Container Registry’yi seçin.
Kimlik Doğrulaması
Yönetilen Kimlik'i seçin.
Kimlik
Açılan menüden oluşturduğunuz kimliği seçin.
Kapsayıcı Kayıt Defteri
Açılan menüden kullanmak istediğiniz kayıt defterini seçin.
Görsel
Kullanmak istediğiniz resmin adını girin.
Resim Etiketi
Çekmek istediğiniz görüntünün adını ve etiketini girin.
Not
Azure Container Registry kayıt defterinizde yönetici kimlik bilgileri etkinleştirilmediyse, bir uyarı iletisi görüntülenir ve görüntü adını ve etiket bilgilerini el ile girmeniz gerekir.
Kaydet'i seçin.
Yeni düzeltme oluştur ve dağıt sayfasında Oluştur'u seçin.
Yeni bir düzeltme oluşturulur ve dağıtılır. Portal, rolü otomatik olarak kullanıcı tarafından atanan yönetilen kimliğe eklemeye acrpull çalışır. Rol eklenmiyorsa, el ile ekleyebilirsiniz.
Kullanıcı tarafından atanan yönetilen kimliği seçin.
Yönetilen kimlik kaynağı sayfasındaki menüden Azure rol atamaları'nı seçin.
Rolün acrpull kullanıcı tarafından atanan yönetilen kimliğe atandığını doğrulayın.
Özel görüntüyle kapsayıcı uygulaması oluşturma
Genel görüntü içeren bir kapsayıcı uygulaması oluşturarak başlamak istemiyorsanız, aşağıdakileri de yapabilirsiniz.
Kullanıcı tarafından atanmış bir yönetilen kimlik oluşturun.
acrpull Rolü kullanıcı tarafından atanan yönetilen kimliğe ekleyin.
Özel görüntü ve kullanıcı tarafından atanan yönetilen kimlik ile bir kapsayıcı uygulaması oluşturun.
Bu yöntem Kod Olarak Altyapı (IaC) senaryolarında tipiktir.
Kaynakları temizleme
Bu uygulamayı kullanmaya devam etmeyecekseniz, kaynak grubunu kaldırarak Azure Container Apps örneğini ve ilişkili tüm hizmetleri silebilirsiniz.
Uyarı
Kaynak grubu silindiğinde gruptaki tüm kaynaklar silinir. Grupta başka kaynaklarınız varsa, bunlar da silinir. Kaynakları korumak istiyorsanız kapsayıcı uygulaması örneğini ve kapsayıcı uygulaması ortamını silebilirsiniz.
Genel Bakış bölümünden kaynak grubunuzu seçin.
Kaynak grubuna Genel Bakış'ın üst kısmındaki Kaynak grubunu sil düğmesini seçin.
Onay iletişim kutusuna kaynak grubu adını girin.
Sil'i seçin.
Kaynak grubunu silme işleminin tamamlanması birkaç dakika sürebilir.
Sistem tarafından atanan yönetilen kimlik
Azure portalında sistem tarafından atanan yönetilen kimliği yapılandırma yöntemi, kullanıcı tarafından atanan yönetilen kimliği yapılandırma yöntemiyle aynıdır. Tek fark, kullanıcı tarafından atanan yönetilen kimlik oluşturmanız gerekmeyecek olmasıdır. Bunun yerine, kapsayıcı uygulamasını oluşturduğunuzda sistem tarafından atanan yönetilen kimlik oluşturulur.
Azure portalında sistem tarafından atanan yönetilen kimliği yapılandırma yöntemi:
Genel görüntü içeren bir kapsayıcı uygulaması oluşturun.
Özel görüntü ve sistem tarafından atanan yönetilen kimlikle bir kapsayıcı uygulaması düzeltmesi oluşturun.
Kapsayıcı Uygulaması Oluştur sayfasının en altındaki Oluştur düğmesini seçin.
Kapsayıcı uygulaması dağıtımının bitebilmesi için birkaç dakika bekleyin. Dağıtım tamamlandığında Kaynağa git'i seçin.
Düzeltmeyi düzenleme ve dağıtma
Kapsayıcıyı düzenleyerek özel Azure Container Registry'nizdeki görüntüyü kullanın ve kimlik doğrulamasını sistem tarafından atanan kimliği kullanacak şekilde yapılandırın.
Kapsayıcıyı düzenle sayfasında aşağıdaki eylemleri gerçekleştirin.
Ayar
Eylem
Ad
Kapsayıcı uygulaması adını girin.
Görüntü kaynağı
Azure Container Registry’yi seçin.
Abonelik
Azure aboneliği seçin.
Kapsayıcı Kayıt Defteri
Kapsayıcı kayıt defterinizi seçin.
Görsel
Resim adını girin.
Resim etiketi
Görüntü etiketini girin.
Kimlik doğrulaması türü
Yönetilen kimlik öğesini seçin.
Yönetilen kimlik
Sistem tarafından atanan'ı seçin.
Sayfanın alt kısmındaki Kaydet'i seçin.
Yeni düzeltme oluştur ve dağıt sayfasının alt kısmındaki Oluştur'u seçin
Birkaç dakika sonra, yeni düzeltmeyi görmek için Düzeltme yönetimi sayfasında Yenile'yi seçin.
Yeni bir düzeltme oluşturulur ve dağıtılır. Portal, rolü otomatik olarak sistem tarafından atanan yönetilen kimliğe eklemeyi acrpull dener. Rol eklenmiyorsa, el ile ekleyebilirsiniz.
Rolün acrpull sistem tarafından atanan yönetilen kimliğe atandığını doğrulayın.
Kaynakları temizleme
Bu uygulamayı kullanmaya devam etmeyecekseniz, kaynak grubunu kaldırarak Azure Container Apps örneğini ve ilişkili tüm hizmetleri silebilirsiniz.
Uyarı
Kaynak grubu silindiğinde gruptaki tüm kaynaklar silinir. Grupta başka kaynaklarınız varsa, bunlar da silinir. Kaynakları korumak istiyorsanız kapsayıcı uygulaması örneğini ve kapsayıcı uygulaması ortamını silebilirsiniz.
Genel Bakış bölümünden kaynak grubunuzu seçin.
Kaynak grubuna Genel Bakış'ın üst kısmındaki Kaynak grubunu sil düğmesini seçin.
Onay iletişim kutusuna kaynak grubu adını girin.
Sil'i seçin.
Kaynak grubunu silme işleminin tamamlanması birkaç dakika sürebilir.
Bu makalede, Azure CLI ve Azure PowerShell kullanarak özel bir Azure Container Registry deposundan görüntü çekmek üzere yönetilen kimlikleri kullanmak üzere kapsayıcı uygulamanızın nasıl yapılandırıldığı açıklanır.
Mayıs 2024'den itibaren Azure CLI uzantıları artık önizleme özelliklerini varsayılan olarak etkinleştirmez. Container Apps önizleme özelliklerine erişmek için ile --allow-preview trueContainer Apps uzantısını yükleyin.
Azure CLI
az extension add --name containerapp --upgrade--allow-previewtrue
Azure PowerShell
Install-Module -Name Az.App
Modülü en son sürüme güncelleştirdiğinden Az.App emin olun.
Azure PowerShell
Update-Module -Name Az.App
Geçerli uzantı veya modül yüklendikten sonra ve Microsoft.OperationalInsights ad alanlarını kaydedinMicrosoft.App.
Ortamı oluşturmak için aşağıdaki komutu çalıştırın:
Azure CLI
az containerapp env create \
--name$CONTAINERAPPS_ENVIRONMENT \
--resource-group$RESOURCE_GROUP \
--location$LOCATION
Container Apps ortamı için Log Analytics çalışma alanı gereklidir. Aşağıdaki komutlar bir Log Analytics çalışma alanı oluşturur ve çalışma alanı kimliğini ve birincil paylaşılan anahtarı değişkenlere kaydeder.
Kullanıcı tarafından atanmış bir yönetilen kimlik oluşturun. Aşağıdaki komutu çalıştırmadan önce PLACEHOLDERS değerini yönetilen kimliğinizin adıyla değiştirin<.>
Azure CLI
IDENTITY="<YOUR_IDENTITY_NAME>"
Azure CLI
az identity create \
--name$IDENTITY \
--resource-group$RESOURCE_GROUP
Kullanıcı tarafından atanmış bir yönetilen kimlik oluşturun. Aşağıdaki komutu çalıştırmadan önce PLACEHOLDERS değerini yönetilen kimliğinizin adıyla değiştirin<.>
Kimliğin kaynak kimliğini kopyalayarak aşağıdaki komuttaki <IDENTITY_ID> yer tutucularına yapıştırın. Görüntü etiketiniz değilse latest, 'latest' yerine etiketinizi yazın.
Aşağıdaki komut, belirtilen kaynak grubunu ve içindeki tüm kaynakları siler. Bu hızlı başlangıcın kapsamı dışındaki kaynaklar belirtilen kaynak grubunda varsa, bunlar da silinir.
Kapsayıcı uygulamasını özel kapsayıcı kayıt defterinizdeki görüntüyle güncelleştirin ve Azure Container Registry çekme işleminin kimliğini doğrulamak için sistem tarafından atanan bir kimlik ekleyin. Giriş, ölçek ve Dapr ayarları gibi kapsayıcı uygulamanız için gerekli olan diğer ayarları da ekleyebilirsiniz.
Aşağıdaki komut, belirtilen kaynak grubunu ve içindeki tüm kaynakları siler. Bu hızlı başlangıcın kapsamı dışındaki kaynaklar belirtilen kaynak grubunda varsa, bunlar da silinir.
Bu makalede, kapsayıcı uygulamanızı özel Azure Container Registry depolarından görüntü çekmek üzere kullanıcı tarafından atanan yönetilen kimlikleri kullanacak şekilde yapılandırmak için Bicep şablonunun nasıl kullanılacağı açıklanmaktadır.
Mayıs 2024'den itibaren Azure CLI uzantıları artık önizleme özelliklerini varsayılan olarak etkinleştirmez. Container Apps önizleme özelliklerine erişmek için ile --allow-preview trueContainer Apps uzantısını yükleyin.
Azure CLI
az extension add --name containerapp --upgrade--allow-previewtrue
Azure PowerShell
Install-Module -Name Az.App
Modülü en son sürüme güncelleştirdiğinden Az.App emin olun.
Azure PowerShell
Update-Module -Name Az.App
Geçerli uzantı veya modül yüklendikten sonra ve Microsoft.OperationalInsights ad alanlarını kaydedinMicrosoft.App.
Diğer geliştiriciler ve uzmanlarla gerçek dünyadaki kullanım örneklerini temel alan ölçeklenebilir yapay zeka çözümleri oluşturmak için toplantı serisine katılın.
Azure Container Registry oluşturmayı ve yapılandırmayı, kapsayıcı görüntülerini Azure Container Registry'ye gönderme işlemini ve Azure Container Registry için farklı kimlik doğrulama yöntemlerini ve güvenlik özelliklerini keşfetmeyi öğrenin.