Azure Pipelines Eğitimi: Yeni Başlayanlar için Eksiksiz CI/CD Rehberi

CI/CD hattınız sürekli bozuluyor ya da yavaş ve hantal mı geliyor? Yalnız değilsiniz. Başarısız derlemeler, uyumsuz ortamlar ve ekip arkadaşlarımın yanlışlıkla çalışmalarımı üzerine yazdığı durumlarla ben de karşılaştım. Azure Pipelines, neredeyse her projeyi her platformda derleyebilen, test edebilen ve dağıtabilen bulut barındırmalı bir hizmetle bu sorunları ortadan kaldırır.

Bu yüzden bu eğitimde size şunları nasıl yapacağınızı göstereceğim:

1. İlk Azure Pipeline’ınızı oluşturma
2. Projenizi bulutta derleme
3. Hataları erken yakalamak için otomatik testler ekleme
4. Tek bir itmeyle geçiş ya da üretime dağıtma
5. Hattınızı hız ve güvenilirlik için izleme ve optimize etme
6. Gerçek projelerde kanıtlanmış en iyi uygulamaları takip etme

Hadi başlayalım!

Azure Pipelines nedir?

Azure Pipelines, uygulama geliştirme, test ve dağıtımı basitleştiren bulut tabanlı bir çözümdür. 

Azure DevOps araç setinin bir bileşenidir ve yazılım geliştirme yaşam döngüsünün tamamını destekler. Çeşitli platformlar ve programlama dillerini desteklediği için her ölçekte ekip için esnek bir seçenektir. GitHub, Azure Repos ve diğer bilinen sürüm kontrol sistemleriyle entegredir. 

Azure Pipelines’ın temel özellikleri şunlardır: 

Deneyimlerime göre, Azure Pipelines, ekibi içinde düzgün bir CI/CD süreci isteyen herkes için faydalıdır. Esnektir, ölçeklenebilirdir ve diğer Azure hizmetleriyle iyi entegre olur.

Azure Pipelines Mimarisi (Kaynak: Microsoft).

Pipelines’ın ötesinde Azure DevOps’u daha geniş bir çerçevede anlamak istiyorsanız, Azure DevOps eğitimi baştan sona tüm CI/CD yaşam döngüsünü adım adım ele alıyor.

İlk Azure Pipeline’ınızı Kurma

Azure Pipelines ortamında çalışmak için önce uçtan uca derleme, test ve dağıtım sürecini mümkün kılacak her şeyi kurmamız gerekir.

Önkoşullar

İlk hattınızı oluşturmaya başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

1. Azure DevOps hesabı ve organizasyon kurulumu: Zaten bir hesabınız yoksa Azure DevOps hesabına kaydolun. Projelerinizi yönetmek için bir organizasyon oluşturun. 
2. Depo: Örnek bir projeye sahip bir kod deposuna ihtiyacınız olacak. Bu, Azure Repos veya GitHub’da barındırılabilir. Bu eğitimde basit bir Node.js projesi kullanacağız.
3. Azure portal erişimi: Azure Kubernetes Service (AKS) ve daha birçok Azure hizmetine dağıtım yapmak istediğinizde Azure portalına da erişiminiz olmalı.

Daha geniş Azure ekosistemini tazelemek isterseniz Understanding Microsoft Azure kursuna göz atmanızı öneririm. 

Yeni proje ve depo oluşturma

Azure DevOps hesabınız ve organizasyonunuz hazır olduğuna göre, ilk projemizi ve depomuzu oluşturalım.

• Yeni bir proje oluşturun:
  • Azure DevOps hesabınıza giriş yapın.
  • New Project’e tıklayın, bir ad verin (ör. "AzureDevOps-DataCamp-Tutorial"), ve görünürlüğü (public veya private) seçin.
  • Create Project’e tıklayın.

• Bir depo kurun:
  • Azure Repos kullanıyorsanız Repos bölümüne gidip yeni bir depo başlatın.
  • Alternatif olarak, Import Repository seçeneğini belirleyerek mevcut bir GitHub deposunu bağlayabilirsiniz.
  • Depo adını verin, Repository type (Git veya TFVC) seçin, klonladığınız depo URL’sini yapıştırın ve Import’a tıklayın.

• GitHub kullanıyorsanız, proje arayüzünüzün sol altından Project Settings > GitHub Connections > Connect your GitHub account seçerek GitHub hesabınızı Azure DevOps’a bağlayabilirsiniz.

Bu eğitim için kod depomuz olarak Azure Repos’u kullanacağız. Yeni başlıyorsanız veya TFVC’yi seçmek için özel bir nedeniniz yoksa Git’i tercih etmenizi öneririm.

İlk hattınızı (pipeline) oluşturma

Şimdi ilk hattımızı oluşturalım. Aşağıdaki adımları izleyin:

• Pipelines bölümünüzde Create Pipeline’a tıklayın.

• Kaynak olarak Azure Repos Git’i seçin ve deponuzu belirleyin.

• Hattınızı YAML veya Classic editor ile yapılandırabilirsiniz. Adım tanımlarını kodla ifade eden YAML’ı seçelim.
• Hattı kaydedin ve her şeyin düzgün çalışıp çalışmadığını görmek için çalıştırın.

YAML mı, Classic Editor mü?

Azure Pipelines hatlarınızı tanımlamak için iki yöntem sunar:

• YAML hatları: Hattınızı kodla tanımlamanın bir yolu. .yaml veya .yml dosyasında kaynak deponuzda tutulur; sürümleme ve daha iyi işbirliği sağlar.
• Classic Editor: Klasik Editor, kullanıcı dostu görsel bir sürükle-bırak arayüzüdür ve daha karmaşık senaryolarda daha az esnektir.

Deneyimlerime göre, YAML hatları Infrastructure as Code (IaC) uygulamalarını izleyen ekipler için daha fazla esneklik sağlar. Ancak Classic Editor, işleri daha görsel şekilde yapmak isteyen yeni başlayanlar için idealdir. 

Bununla birlikte, uzun vadeli ölçeklenebilirlik için Classic Editor yerine YAML hatları önerilir.

Azure Pipelines ile Derleme

Şimdi Azure Pipelines ile nasıl derleme yapabileceğimize bakalım. 

Bu bölümde Azure Pipelines’ın bağımlılıkları yükleme, derleme ve testleri çalıştırma gibi kodunuzu derlemek için attığı adımları belirleyeceğiz. Bu adımları, kaynak kod depomuzda YAML kullanarak bir yapılandırma dosyasında ifade edeceğiz; YAML, tarifteki adımları basit ve insan tarafından okunabilir şekilde tanımlamanın bir yoludur.

YAML hat sözdizimi

İşte basit bir YAML hat örneği:

# This section defines the trigger(s) for the pipeline.
# 'main' specifies that the pipeline will run whenever changes are pushed to the 'main' branch.
trigger:
- main  # automatically triggers this pipeline when changes are made to the 'main' branch.

# This defines the pool where the pipeline will run.
# 'ubuntu-latest' specifies the virtual machine image for executing tasks.
pool:
  vmImage: 'ubuntu-latest'  # This uses the latest Ubuntu image provided by Azure DevOps.

# Steps contain the individual tasks or actions that the pipeline will execute.
steps:
- script: echo Hello, world!  # A script task to run shell commands. This one prints "Hello, world!".
  displayName: 'Run my first pipeline script'  # A friendly name for this step, making it easier to identify in the pipeline logs.

Kodu adım adım inceleyelim:

• trigger: Hattı tetikleyen dalı belirtir (ör. main).
• pool: Derleme aracısını tanımlar (ör. ubuntu-latest).
• steps: Bağımlılıkları yüklemek ve derleme betiğini çalıştırmak gibi yürütülecek görevleri listeler.

Derleme adımlarını yapılandırma

YAML hattınıza derleme adımları eklemek için ‘steps’ bölümü altında ‘script’ tanımlamanız gerekir.

Basit bir Node.js uygulaması için örneğin, aşağıdaki azure-pipelines.yml dosyamızda Azure DevOps’un otomatik oluşturduğu kod bulunur.

# Node.js
# Build a general Node.js project with npm.
# Add steps that analyze code, save build artifacts, deploy, and more:
# https://docs.microsoft.com/azure/devops/pipelines/languages/javascript

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '20.x'
  displayName: 'Install Node.js'

- script: |
    npm install
    npm run build
  displayName: 'npm install and build'

Yukarıdaki YAML hattındaki steps bölümüne bakalım: 

1. Node.js’i yükleyin: Node.js sürümünü belirtmek için NodeTool@0 görevi kullanın. 
2. Bağımlılıkları yükleyin: Proje bağımlılıklarını yüklemek için npm install çalıştırın. 
3. Kodu derleyin (projeyi build edin): Kodu derlemek için npm run build çalıştırın. 

Hattı çalıştırma

Hattımızı manuel olarak tetikleyebilir veya dal itmeleri gibi olaylar gerçekleştiğinde otomatik çalışacak şekilde ayarlayabiliriz.

• Manuel tetikleme: Hattı manuel tetiklemek için Azure DevOps arayüzünde Run Pipeline’a tıklayın.

• Otomatik tetikleme: Depo olaylarına dayalı tetikleyiciler kurun; main dalına yapılan itmeler hattı otomatik tetiklesin. Örnek:

trigger:
- main

Hattınızı çalıştırdıktan sonra günlükleri görüntüleyebilir ve sorun giderebilirsiniz.

Günlüklere erişmek için hat çalıştırma özetine gidip belirli işi veya görevi seçin. Bu, o adıma ait günlükleri gösterecektir; aşağıdaki görselde olduğu gibi ham günlükleri görüntülemek için herhangi bir işi (Build, Push veya Update) seçebilirsiniz.

Yaygın sorunları gidermek için zaman aşımı, kaynak kısıtları veya yanlış yapılandırmalar gibi tipik problemleri kontrol edebilirsiniz.

Hattınıza Testler Ekleme

Kod kalitesini sağlamak ve sorunları geliştirme sürecinin başında yakalamak için hattınıza testler eklersiniz. Azure Pipelines’ta birim, entegrasyon veya diğer testleri hat yapılandırmanıza adımlar ekleyerek entegre edebilirsiniz.

Test adımlarını yapılandırma

Hattınıza test adımları dahil ederek kod kalitesini güvence altına alın. Jest, Mocha veya NUnit gibi popüler çerçeveleri kullanabilirsiniz. Örneğin, Jest ile birim testleri şöyle eklenir:

- script: |
    npm test
  displayName: 'Run unit tests with Jest'

Test sonuçlarını görüntüleme

Azure Pipelines’ta yerleşik test raporlama bulunur. Takibi kolaylaştırmak için test sonucu yayımlamayı ayarlayabilir ve test sonuçlarını hat günlüklerinde görüntüleyebilirsiniz. İşte nasıl:

• Önce Builds > Test Results bölümüne gidin.
• Test sonuçlarını yayımlamak için PublishTestResults@2 görevini kullanın. Bu, genel takibi kolaylaştırır. Örneğin:

- task: PublishTestResults@2
  inputs:
    testResultsFiles: '**/test-results.xml'
    testRunTitle: 'Unit Tests'

Azure Pipelines ile Dağıtım

Azure hattı YAML dosyanızdaki dağıtım adımlarında, uygulamanızı test, hazırlık (staging) ve üretim gibi çeşitli ortamlara otomatik olarak dağıtabilirsiniz. Bu bölümde Azure Pipelines ile dağıtım yapmanın birkaç yolunu gözden geçireceğiz.

Azure Web Apps’e dağıtım

Azure Web Apps, Azure Portal’da ölçekli şekilde web uygulamaları geliştirmenizi, dağıtmanızı ve yönetmenizi sağlayan bir hizmettir. 

Azure Web Apps’e dağıtım için iki hizmeti birbirine bağlamanız gerekir. İşte nasıl:

• Projenizin sol altından Project Settings bölümüne gidin ve Pipelines altındaki Service Connections ögesine tıklayın. 

• New Service Connection’a tıklayın ve Azure Resource Manager’ı seçin. 

• Azure hesabınızla kimlik doğrulayın.
• Azure App Service’e dağıtın:
  • Pipelines bölümüne geri dönün ve hattınızı yapılandırın.
  • Hattınıza Azure’a dağıtım yapacak bir görev ekleyin.
  • Kaynak grubu ve hizmet ayrıntılarını belirtin. 

İşte basit bir Node.js uygulamasını Azure App Service’e dağıtmak için bir YAML dağıtım hattı örneği:

# Define the task for deploying to an Azure Web App
- task: AzureWebApp@1
  inputs:
    # This specifies your Azure subscription service connection
    azureSubscription: 'your-azure-subscription'
    # This specifies the name of your web app
    appName: 'your-app-name'
    # This specifies the location of the app package or files to be deployed
    package: '$(Build.ArtifactStagingDirectory)'

Yukarıdaki kodu kendi kullanım senaryonuza uyarlayabilmeniz için parçalayalım:

• your-azure-subscription ifadesini, Azure aboneliğinize erişim veren servis bağlantısının adıyla değiştirin.
• your-app-name ifadesini Azure’daki web uygulamanızın gerçek adıyla değiştirin. 
• $(Build.ArtifactStagingDirectory) ifadesini dağıtım için web uygulaması paketini veya dosyalarını koyacağınız dizinle değiştirin. $(Build.ArtifactStagingDirectory) — Bu değişken, derlemeden sonra uygulama dosyalarınızın (build artifaktlarınızın) bulunduğu klasörü işaret eder.

Sürekli dağıtımı (CD) kurma

Kodumuzdaki her şey tüm testlerden ve kontrollerden geçtiğinde sıradaki adım sürekli dağıtımı kurmaktır. Aşağıda açıklanan adımları izleyin.

Azure yayın hattı dağıtım modeli (Kaynak: Microsoft)

• Bir yayın hattı oluşturun:
• Pipelines > Releases bölümüne gidin ve New Pipeline’a tıklayın.

• Azure App Service Deployment şablonunu seçin.

• Ortamları yapılandırın:
• Uygulamanızın dağıtılmasını istediğiniz Dev, Staging, QA ve Production ortamlarını ekleyin ve yapılandırın.

• Yayın hattının kaynağı olarak derleme hattınızdan gelen artifaktı bağlamak için Add an artifact seçeneğini belirleyin.

• Onayları ve geçitleri (gates) yapılandırın:
• Üretim gibi hassas ortamlar için dağıtım öncesi onayların ayarlanması gereklidir. Örneğin, yayın için bir ekip liderinin onayı gerekebilir. Dağıtımın kalite standartlarını karşıladığından emin olmak için otomatik testler veya izleme kontrolleri gibi geçitler de ekleyebilirsiniz.

Deneyimlerime göre, bu aşama zorlu geliştirme ortamlarında istikrarı korumak için gereklidir. Onaylar ve geçitler, kontrol sağlar ve üretime yalnızca yüksek kaliteli kodun ulaşmasını güvence altına alır.

Kubernetes’e dağıtım

Kubernetes, konteynerleştirilmiş uygulamaları güvenilir ve ölçeklenebilir şekilde çalıştırmayı kolaylaştırır. Azure Kubernetes Service (AKS) kullandığınızda, dağıtımı ve işletimi basitleştiren yönetilen bir ortam elde edersiniz. Bu bölümde, Azure Pipelines kullanarak uygulamanızı AKS’ye nasıl dağıtacağınızı göstereceğim.

AKS kümenizi hazırlayın

AKS kümesini Azure portalı veya CLI ile oluşturabilirsiniz. İşte küme sağlamak için temel bir Bash CLI komutu:

az aks create \
  --resource-group <ResourceGroupName> \
  --name <AKSClusterName> \
  --node-count 3 \
  --enable-addons monitoring \
  --generate-ssh-keys

Yukarıdaki komutu açıklayalım:

• --resource-group: AKS kümesinin oluşturulacağı Azure kaynak grubunu belirtir.
• --name: AKS kümenizin adını ifade eder.
• --node-count: Kümedeki düğüm sayısını ayarlar (örnekte 3).
• --enable-addons monitoring: Azure Monitor for Containers ile izleme ve analitiği etkinleştirir.
• --generate-ssh-keys: Sağlanmamışsa düğümlere güvenli erişim için SSH anahtarlarını otomatik oluşturur.

<ResourceGroupName> ve <AKSClusterName> ifadelerini, gerçek kaynak grubu ve küme adlarınızla değiştirmeyi unutmayın.

AKS kümeniz kurulduktan sonra kubectl yapılandırılmalıdır. Bu, hat aracısının veya yerel bilgisayarınızın küme ile kubectl üzerinden iletişim kurabilmesini sağlar.

Komut satırı araçlarıyla Azure görevlerinizi hızlandırabilirsiniz—şu Azure CLI cheat sheet hızlı bir başvuru kaynağıdır.

Bir dağıtım YAML dosyası oluşturun 

Kubernetes’e bir Docker imajı dağıtmak için temel bir dağıtım YAML dosyasını örnek alalım:

# This defines the API version and the kind of Kubernetes resource we are creating.
# 'apps/v1' is the API version, and 'Deployment' is the resource type.
apiVersion: apps/v1
kind: Deployment

# Metadata contains information to identify the resource uniquely.
# 'name' specifies the name of the Deployment.
metadata:
  name: my-app  # Name of the Deployment, used for identification.

# "spec" specifies the intended deployment state.
spec:
  # Number of replicas/pods we want for this Deployment.
  replicas: 3  # Ensures high availability by running three app replicas.

  # Selector is used to define the labels that this Deployment will manage.
  selector:
    matchLabels:
      app: my-app  # This ensures that only Pods with the label 'app: my-app' are managed by this Deployment.

  # Template specifies the blueprint for the pods created by the Deployment.
  template:
    metadata:
      labels:
        app: my-app  # Labels for the Pods, matching the selector above.

    # A specification for the containers of the Pods.
    spec:
      containers:
      - name: my-app  # Name of the container. This is useful for linking to the container in logs, etc.
        image: mycontainerregistry.azurecr.io/my-app:latest  # Pull the container image you will call from your container registry.
        ports:
        - containerPort: 80  # The container listens on port 80.

Azure Pipelines kullanarak dağıtım

YAML hattınıza AKS’ye dağıtım yapacak bir görev ekleyin.

# This defines a task for deploying Kubernetes manifests within an Azure DevOps pipeline.
- task: KubernetesManifest@0  # Task type for working with Kubernetes manifest files.
  inputs:
    # This configures what to do with the Kubernetes manifest files.
    action: 'deploy'  # 'deploy' action ensures the Kubernetes manifests are applied to the cluster.

    # This defines the namespace where the Kubernetes resources will be deployed.
    namespace: 'default'  # 'default' is the namespace for deploying resources. Change if needed.

    # All this does is point to the manifest files that define the desired state of your Kubernetes resources.
    manifests: '$(Build.ArtifactStagingDirectory)/manifests/*.yaml'
    # The 'manifests' variable points to the location of all the YAML files (e.g., Deployment, Service, etc.) that will be applied during the deployment.

    # To access private container registry images, use the image pull secret.
    imagePullSecrets: 'my-registry-secret'
    # This instructs Kubernetes on which secret to use when pulling images from a private container registry.
    # Ensure that 'my-registry-secret' exists in the namespace before the deploy

Dağıtımı tetiklemek için YAML dosyasını commit edin ve push’layın.

AKS, ölçekleme, güncellemeler ve geri almaları yönetmeyi kolaylaştırarak konteyner düzenlemeyi basitleştirir. Deneyimlerime göre, modern bulut yerel uygulamalar için vazgeçilmezdir.