“Infrastructure as Code Nedir” terimini ilk kez duyduysanız infra nasıl kod olarak tanımlanabiliyor diye düşünebilirsiniz. Bunun için ilk akla gelebilecek örnekler portal üzerinden “next next” yapmadan Azure deployment template’leri ve Azure CLI kullanmak ve bu işin otomasyonunu sağlamak olarak düşünebiliriz. Peki gerçekten “as code” olarak bu işi nasıl yapabiliriz?
Pulumi tam burada devreye giriyor ve bize TypeScript, JavaScript, Python ve (henüz preview olsa da) .NET Core desteği ile C#, VB.NET veya F# kullanabilmemizi sağlıyor. Pulumi sadece resource oluşturmak için değil aynı zamanda mevcut resource’ları da yönetebilmemize de imkan sağlıyor. Ayrıca Azure dışında AWS ve Google Cloud üzerinde de kullanabilirsiniz.
Basit bir örnekle başlayalım ve (Azure Portal kullanmadan) Azure Container Registry oluşturalım.
Öncelikle bilgisayarınızda (örneği Windows 10 üzerinde yapacağız) Pulumi kurmamız gerekiyor. Bunun için aşağıdaki PowerShell script’ini Resim-1‘de gördüğünüz gibi çalıştırarak ilgili SDK’yı indirip, pulumi CLI komutlarını kullanmak için gerekli olan $PATH değişkenine tanımlama yapacağım.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12;
iex ((New-Object System.Net.WebClient).DownloadString('https://get.pulumi.com/install.ps1'));
[Environment]::SetEnvironmentVariable("%PATH%", "%USERPROFILE%\.pulumi\bin");
Resim-1
NOT: Bilgisayarınızda pulumi cli ile yapacağımız işlemler öncesinde az login komutu (Azure CLI kurulu olmalı) ile mevcut Azure hesabınıza bağlanmanız gerekiyor. Azure CLI kurulu değilse buradan kurabilirsiniz.
Pulumi ile gelen azure-csharp template’ini kullanarak başlayalım. Resim-3‘te göreceğiniz gibi pulumi new azure-csharp komutunu çalıştırdığınızda bize access token ya da Azure CLI’da olduğu gibi browser açarak login olabileceğimizi söylüyor.
Resim-3
Browser seçeneği ile ilerlemeyi seçiyorum ve Resim-4‘te göreceğiniz pulumi login sayfası açılıyor. Pulumi’ye GitHub, GitLab, Atlassian ya da bu hesaplara sahip değilseniz klasik yöntem olarak email/password ile giriş yapabilirsiniz. Ben klasik yöntemi tercih edeceğim diyorsanız Pulumi üzerinde hesap açmak için buraya tıklayabilirsiniz.
Resim-4
Login işlemi sonrasında Resim-5‘te göreceğiniz hoş geldin ekranı ile bizden proje ile ilgili bazı bilgileri istiyor. Proje adını varsayılan değer olarak mevcutta bulunan klasör adı (örnekte mshowto) olarak alıyor. Proje tanımı ve oluşturacağı stack (development) bilgilerini ise varsayılan olarak bırakıp, Azure datacenter lokasyonunu ise WestEurope olarak değiştiriyorum.
Resim-5
Projenin bağımlı olduğu paketlerin kurulumu tamamlandıktan sonra dotnet build komutunu çalıştırılıyor. Pulumi’nin azure-csharp template’inde yer alan ve örnek bir Azure Storage oluşturduğu projeyi Resim-6‘da görebilirsiniz. Burada Azure Portal üzerinde yaptığımız gibi öncelikle bir Resource Group oluşturuyor. Sonra bir (Storage) Account nesnesi oluşturup gerekli olan ResourceGroupName, ReplicationType ve AccountTier değerleri set ediliyor. Son olarak da işlem bittiği zaman geriye dönecek olan primary connection string değeri tanımlanıyor. Burada farklı bir değer de dönebilirsiniz.
Resim-6
Örnekte Resource Group ya da Storage Account için Azure lokasyonu belirtmedik. Bu durumda CLI üzerinde belirtmiş olduğumuz lokasyonu kullanıyor. Bunu pulumu.dev.yaml dosyası içerisinde de görebilirsiniz; pulumi.yaml dosyası içerisinde ise proje adı, kullandığımız runtime (dotnet) ve yine CLI üzerine belirttiğimiz proje detayı bilgilerini bulabilirsiniz.
Yazının başında Azure Container Registry oluşturacağımızı belirtmiştim, bunun için örnek kod üzerinde Resim-7‘de göreceğiniz değişiklikleri yaparak devam ediyorum. Resource Group adını mshowto_rg olarak değiştiriyorum ve mshowtocr adında bir (Container) Registry objesi oluşturuyorum. Burada da RegistryArgs olarak ResourceGroupName ve Sku değerlerini set ediyorum. Geri dönüş değeri olarak da container registry’nin Id değerini kullanıyorum.
Resim-7
Şimdi tekrar PowerShell ekranına dönüyorum ve projeyi oluşturduğumuz klasör içerisinde pulumi up komutunu çalıştırıyorum (Resim-8). Burada bize oluşturacağı resource’lar ile bilgilerin özetini verip bu güncellemeyi yapmak isteyip istemediğimiz soruyor, “yes” seçeneği ile devam ediyorum.
Resim-8
Kod üzerinde belirttiğimiz resource’lar Azure üzerinde oluşturulduktan sonra bize Resim-9‘da göreceğiniz gibi container registry id değerini, kaç tane resource oluşturduğunu ve bu işlemlerin ne kadar zaman aldığı gibi bilgileri veriyor. Ayrıca pulumi üzerindeki ilgili stack’e gidebilmemiz için bir de url bulunuyor.
Resim-9
Şimdi de Azure Portal’a giderek gerçekten istediğimiz resource’lar oluşturuldu mı diye bakıyorum. Resim-10‘da göreceğiniz gibi kod üzerinde belirttiğimiz isimlerin sonuna bir ekleme yapılmış. Bu pulumi tarafından isimlerin benzersiz (unique) olmasını sağlamak için yapılan bir işlem.
Resim-10
Fakat ben isimlerin benzersiz olduğuna eminim ve sonuna yapılan eklemeleri istemiyorum diyorsanız Resim-11‘de göreceğiniz gibi ResourceGroup ve Registry nesnelerini oluştururken, constructor parametresine ek olarak tekrar Name değerini set ederek bu sorunu çözebilirsiniz.
Resim-11
Pulumi web sayfası üzerinde yer alan stack bilgilerine de Resim-12‘de göreceğiniz gibi erişebilirsiniz. Activity sekmesi altında yaptığınız güncelleme detaylarını, Resources sekmesi altında ise bu stack’te yer alan resource bilgilerine ulaşabilirsiniz. Bu stack altında yer alan resource veya stack’in kendisini silmek istiyorsanız Settings sekmesine gidebilirsiniz.
Resim-12
Bu konuyla ilgili sorularınızı alt kısımda bulunan yorumlar alanını kullanarak sorabilirsiniz.
Referanslar
https://docs.microsoft.com/en-gb/azure/container-registry/
TAGs: Azure, Azure Portal, Yazılım Geliştiriciler için Azure, Azure Container Registry, ACR, PowerShell, Azure CLI, Containers, .NET, .NET Core, Pulumi, Infrastructure as Code
