AWSAmplifyDomainRole Bulunamıyor: Hızlı Bir Düzeltme

AWS Amplify ile uygulamanızı dağıtırken yolunuza devam ediyorsunuz ve sonra da oluyor. Bir dağıtım başarısız oluyor ve size gizemli bir hata mesajı geliyor: The role with name AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L cannot be found. Uzun sayı ve harf dizisi herkes için farklıdır ama sorun aynıdır. Bu beklenmedik engel, dağıtımınızı durdurabilir.

Bu sorunla karşılaştıysanız, yalnız değilsiniz. Bu, Amplify Hosting ile özel alan adları yönetirken ortaya çıkabilen bilinen bir sorundur. Bu kılavuz, bu hatanın ne anlama geldiğini tam olarak açıklayacak ve projenize geri dönmenizi sağlayacak net, adım adım bir çözüm sunacaktır.

”AWSAmplifyDomainRole Bulunamıyor” Hatasını Anlamak

Peki bu AWSAmplifyDomainRole nedir ve neden bazen kaybolur?

Amplify uygulamanıza özel bir alan adı eklediğinizde, Amplify bir IAM (Identity and Access Management) rolü oluşturur. AWSAmplifyDomainRole-… olarak adlandırılan bu rol, Amplify’a alan adınızla ilgili kaynakları yönetmek için gerekli izinleri verir. Örneğin AWS Certificate Manager (ACM) üzerinden SSL/TLS sertifikaları gibi.

Hata, bu temel IAM rolü silindiğinde ancak Amplify yapılandırmasının hala varlığını beklediğinde oluşur. Bu birkaç nedenle olabilir:

• Manuel Silme: Ekibinizdeki biri, belki de kullanılmayan rolleri temizlerken, rolü IAM konsolundan yanlışlıkla silmiş olabilir.
• Otomatik Komut Dosyaları: Kullanılmayan AWS kaynaklarını kaldırmak için tasarlanmış temizleme komut dosyaları, bu rolü yanlışlıkla hedef alıp silebilir.
• Alan Adı Yeniden Yapılandırması: Bazen belirli bir sırada özel bir alan adını kaldırıp yeniden eklemek, yapılandırmanın tutarsız bir durumda kalmasına yol açabilir ve bu da rol silinirken ona yapılan referansın kalmasına neden olur.

Nedeni ne olursa olsun, sonuç Amplify artık alan adınızı yönetmek için ihtiyaç duyduğu rolü bulamadığı için dağıtımın başarısız olmasıdır.

Çözüm: IAM Rolünü Yeniden Oluşturmak

Rol eksik olduğundan, en doğrudan çözüm doğru izinlerle yeniden oluşturmaktır. Bu işlem, Amplify’ın rolü üstlenebilmesi için belirli bir güvenilirlik ilkesi (trust policy) eklenmiş yeni bir IAM rolü oluşturmayı içerir.

Bu sorun topluluk tarafından tartışılmış ve buradaki GitHub sorununda izleniyor olsa da bir yamayı beklemeniz gerekmez. Aşağıdaki adımları izleyerek sorunu kendiniz sadece birkaç dakikada çözebilirsiniz.

AWSAmplifyDomainRole Oluşturma Adım Adım Kılavuzu

Gerekli IAM rolünü oluşturma sürecinden geçelim. Başlamadan önce AWS Konsolunuzda oturum açtığınızdan emin olun.

Adım 1: IAM Konsoluna Gitmek

Önce AWS Konsolunuzda IAM servisine gidin. Ana arama çubuğuna “IAM” yazıp sonuçlardan seçerek bulabilirsiniz.

Adım 2: Yeni Bir Rol Oluşturmak

IAM kontrol panelinde, sol taraftaki navigasyon panelinde “Roles” (Roller) üzerine tıklayın. Ardından “Create role” (Rol oluştur) düğmesine tıklayın.

Adım 3: Güvenilir Varlığı Seçmek

Bu en kritik adımdır. AWS’ye bu rolü hangi servisin kullanmasına izin verileceğini söylemeniz gerekir.

1. Güvenilir varlık türü için “Custom trust policy” (Özel güvenilirlik ilkesi) seçeneğini seçin.
2. Bir JSON editörü görünecektir. Varsayılan içeriği aşağıdaki ilke ile değiştirin:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "amplify.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Bu ilke, AWS Amplify servisinin (amplify.amazonaws.com) bu rolü üstlenmesine açıkça izin verir.

İkeyi yapıştırdıktan sonra “Next” (İleri) üzerine tıklayın.

Adım 4: İzinler Eklemek (İsteğe Bağlı ancak Önerilen)

“Add permissions” (İzinler ekle) sayfasında, bu özel düzeltme için kesinlikle herhangi bir ilke eklemeniz gerekmez. Güvenilirlik ilişkisi ana kısımdır. Ancak Amplify, sertifikaları yönetmek için bu rolü kullanır. Eğer sorunlarla karşılaşmaya devam ederseniz, genellikle Amplify bunu yönettiği için gerekli olmasa da güvende olmak için yönetilen AWS ilkesi AWSCertificateManagerFullAccess ekleyebilirsiniz.

Bu kılavuzda, güvenilirlik ilkesi hatayı çözmek için yeterli olduğundan ek izinler eklemeyi atlayacağız. “Next” üzerine tıklayın.

Adım 5: Rolü Adlandırmak ve Sonlandırmak

Şimdi rolü adlandırmanız gerekecek. Bu başka bir kritik adımdır - ad tam olarak olmalıdır.

1. “Role name” (Rol adı) için, hata mesajınızda gösterilen tam adı girin, örneğin AWSAmplifyDomainRole-Z073737928BZTN2WA6J6L.
2. İsteğe bağlı bir açıklama ekleyebilirsiniz, örneğin “AWS Amplify’ın özel alan adı kaynaklarını ve SSL sertifikalarını yönetmesi için rol.”
3. Ayrıntıları gözden geçirin; güvenilir varlığın amplify.amazonaws.com ve rol adının doğru olduğundan emin olun.
4. “Create role” (Rol oluştur) düğmesine tıklayın.

Rolün oluşturulduğunu onaylayan bir başarı mesajı görmelisiniz.

Adım 6: Amplify Dağıtımınızı Yeniden Deneyin

AWSAmplifyDomainRole artık yerine geri döndüğüne göre, AWS Amplify konsolunuza geri dönün ve daha önce başarısız olan derlemeyi veya dağıtımı yeniden başlatın. Amplify artık gerekli rolü bulabilecek ve alan adı yönetimi görevleriyle devam ederek hatayı çözecektir.

Daha Kalıcı Bir Düzeltme: Kazara Silmeyi Önleyin

Rolü yeniden oluşturmak hızlı bir düzeltmedir, ancak bunun gelecekte tekrar olmasını nasıl önlersiniz?

1. Ekibinizi Eğitin: IAM erişimi olan herkesin AWSAmplifyDomainRole’ün önemini anladığından emin olun. Artık kullanımda olmadıklarından emin olmadıkça IAM rollerini silmemeleri konusunda onları uyarın.
2. Kaynaklarınıza Etiketler Uygulayın: AWSAmplifyDomainRole’e etiketler uygulayın (örneğin, Project: MyApp, ManagedBy: Amplify). Bu bağlam ekler ve kişilerin veya otomatik komut dosyalarının kazara silmesini önlemeye yardımcı olabilir.
3. Temizleme Komut Dosyalarını İyileştirin: Kullanılmayan AWS kaynaklarını temizlemek için komut dosyaları kullanıyorsanız, AWSAmplifyDomainRole adını taşıyan veya Amplify tarafından yönetildiği olarak etiketlenmiş roller için bir istisna ekleyin.

Sonuç

AWSAmplifyDomainRole cannot be found hatasıyla karşılaşmak, AWS Amplify ile özel alan adları kullanan geliştiriciler için yaygın bir sorundur. Neyse ki, çözüm basittir. Eksik IAM rolünü doğru güvenilirlik ilkesiyle manuel olarak yeniden oluşturarak dağıtım boru hattınızı hızlıca engelleyebilirsiniz.

Bu kılavuz, bir servis güncellemesini beklemeden sorunu kendiniz çözme gücü verir. Rolünüz geri getirildiğinde ve derlemeniz geçtiğinde, en önemli şeye geri dönebilirsiniz: Harika uygulamalar oluşturmak ve dağıtmak.

---

Meta Bilgileri

Meta Başlığı: Düzeltme: AWS Amplify’de AWSAmplifyDomainRole Bulunamıyor
Meta Açıklaması: “AWSAmplifyDomainRole cannot be found” hatası mı alıyorsunuz? Adım adım kılavuzumuz, bu AWS Amplify sorununu nasıl düzelteceğinizi ve dağıtımınızın çalışmasını sağlayacağınızı gösteriyor.