Aracılığıyla paylaş

Öğretici: GitOps ile CI/CD uygulama (Flux v2)

  • Makale

Bu öğreticide, Flux v2 ve Azure Arc özellikli Kubernetes veya Azure Kubernetes Service (AKS) kümeleri ile GitOps kullanarak bir CI/CD çözümü ayarlayacaksınız. Örnek Azure Vote uygulamasını kullanarak şunları yapacaksınız:

  • Azure Arc özellikli bir Kubernetes veya AKS kümesi oluşturun.
  • Uygulamanızı ve GitOps depolarınızı Azure Repos veya GitHub'a bağlayın.
  • Azure Pipelines veya GitHub ile CI/CD akışı uygulayın.
  • Azure Container Registry'nizi Azure DevOps ve Kubernetes'e bağlayın.
  • Ortam değişkeni grupları veya gizli dizileri oluşturun.
  • ve stage ortamlarını dağıtındev.
  • Uygulama ortamlarını test edin.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Azure Cloud Shell

Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell'i barındırıyor. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Cloud Shell önceden yüklenmiş komutlarını kullanabilirsiniz.

Azure Cloud Shell'i başlatmak için:

Seçenek Örnek/Bağlantı
Kodun veya komut bloğunun sağ üst köşesindeki Deneyin'i seçin. Deneyin seçildiğinde kod veya komut otomatik olarak Cloud Shell'e kopyalanmaz. Azure Cloud Shell için Deneyin örneğini gösteren ekran görüntüsü.
https://shell.azure.comadresine gidin veya Cloud Shell'i tarayıcınızda açmak için Cloud Shell'i Başlat düğmesini seçin. Azure Cloud Shell'i başlatma düğmesi.
Azure portalının sağ üst kısmındaki menü çubuğunda Cloud Shell düğmesini seçin. Azure portalında Cloud Shell düğmesini gösteren ekran görüntüsü

Azure Cloud Shell'i kullanmak için:

  1. Cloud Shell'i başlatın.

  2. Kodu veya komutu kopyalamak için kod bloğundaki (veya komut bloğundaki) Kopyala düğmesini seçin.

  3. Windows ve Linux'ta Ctrl+Shift V'yi seçerek veya macOS üzerinde Cmd+Shift++V'yi seçerek kodu veya komutu Cloud Shell oturumuna yapıştırın.

  4. Kodu veya komutu çalıştırmak için Enter'ı seçin.

Önkoşullar

Azure Container Registry'yi Kubernetes'e bağlama

Azure Container Registry'nizden görüntü çekmek için Kubernetes kümenizi etkinleştirin. Özelse kimlik doğrulaması gereklidir.

Azure Container Registry'yi mevcut AKS kümelerine bağlama

Aşağıdaki komutu kullanarak mevcut bir Azure Container Registry'yi mevcut AKS kümeleriyle tümleştirin:

az aks update -n arc-cicd-cluster -g myResourceGroup --attach-acr arc-demo-acr

Görüntü çekme gizli dizisi oluşturma

AKS olmayan ve yerel kümeleri Azure Container Registry'nize bağlamak için bir görüntü çekme gizli dizisi oluşturun. Kubernetes, kayıt defterinizin kimliğini doğrulamak için gereken bilgileri depolamak için görüntü çekme gizli dizilerini kullanır.

Aşağıdaki kubectl komutla bir görüntü çekme gizli dizisi oluşturun. Hem hem stage de dev ad alanları için yineleyin.

kubectl create secret docker-registry <secret-name> \
    --namespace <namespace> \
    --docker-server=<container-registry-name>.azurecr.io \
    --docker-username=<service-principal-ID> \
    --docker-password=<service-principal-password>

Her pod için imagePullSecret ayarlamak zorunda kalmamak için ve stage ad alanlarına ImagePullSecret öğesini Hizmet hesabına dev eklemeyi göz önünde bulundurun. Daha fazla bilgi için Bkz . Kubernetes öğreticisi.

Tercih ettiğiniz CI/CD düzenleyiciye bağlı olarak, Azure DevOps veya GitHub yönergeleriyle devam edebilirsiniz.

Azure DevOps ile CI/CD uygulama

Bu öğreticide Azure DevOps, Azure Repos ve Pipelines ve Azure CLI hakkında bilgi sahibi olduğunuz varsayılır.

Önce aşağıdaki adımları tamamladığınızdan emin olun:

Uygulama ve GitOps depolarını Azure Repos'a aktarma

Uygulama deposunu ve GitOps deposunu Azure Repos'a aktar. Bu öğretici için aşağıdaki örnek depoları kullanın:

  • arc-cicd-demo-src uygulama deposu

  • arc-cicd-demo-gitops GitOps deposu

Git depolarını içeri aktarma hakkında daha fazla bilgi edinin.

Not

Uygulama ve GitOps depoları için iki ayrı depo içeri aktarmak ve kullanmak güvenliği ve basitliği artırabilir. Uygulama ve GitOps depolarının izinleri ve görünürlüğü ayrı ayrı ayarlanabilir. Örneğin, küme yöneticisi uygulama kodunda kümenin istenen durumuyla ilgili değişiklikleri bulamıyor olabilir. Buna karşılık, bir uygulama geliştiricisinin her ortam için belirli parametreleri bilmesi gerekmez. Parametreler için kapsam sağlayan bir dizi test değeri yeterli olabilir.

GitOps deposunu bağlama

Uygulamanızı sürekli dağıtmak için GitOps kullanarak uygulama deposunu kümenize bağlayın. arc-cicd-demo-gitops GitOps deponuz, arc-cicd-cluster kümenizde uygulamanızı çalışır duruma getirmek için temel kaynakları içerir.

İlk GitOps deposu yalnızca dağıtım ortamlarına karşılık gelen geliştirme ve aşama ad alanlarını oluşturan bir bildirim içerir.

Oluşturduğunuz GitOps bağlantısı otomatik olarak:

  • Bildirim dizinindeki bildirimleri eşitleyin.
  • Küme durumunu güncelleştirin.

CI/CD iş akışı, uygulamayı dağıtmak için bildirim dizinini ek bildirimlerle doldurur.

  1. Azure Repos'ta yeni içeri aktarılan arc-cicd-demo-gitops deponuza yeni bir GitOps bağlantısı oluşturun.

    az k8s-configuration flux create \
   --name cluster-config \
   --cluster-name arc-cicd-cluster \
   --namespace flux-system \
   --resource-group myResourceGroup \
   -u https://dev.azure.com/<Your organization>/<Your project>/_git/arc-cicd-demo-gitops \
   --https-user <Azure Repos username> \
   --https-key <Azure Repos PAT token> \
   --scope cluster \
   --cluster-type connectedClusters \
   --branch master \
   --kustomization name=cluster-config prune=true path=arc-cicd-cluster/manifests

    İpucu

    AKS kümesi için (Arc özellikli küme yerine) kullanın -cluster-type managedClusters.

  2. Azure portalında dağıtımın durumunu denetleyin.

    • Başarılı olursa kümenizde hem hem de devstage ad alanlarının oluşturulduğunu görürsünüz.
    • Ayrıca kümenizin Azure portalı sayfasında fGitOps sekmesinde bir yapılandırma cluster-config oluşturulduğunu da onaylayabilirsiniz.

CI/CD işlem hatlarını içeri aktarma

GitOps bağlantısını eşitlediğinize göre, bildirimleri oluşturan CI/CD işlem hatlarını içeri aktarmanız gerekir.

Uygulama deposu, PR'ler, CI ve CD için kullanılan işlem hatlarının bulunduğu bir .pipeline klasör içerir. Örnek depoda sağlanan üç işlem hattını içeri aktarın ve yeniden adlandırın:

İşlem hattı dosya adı Açıklama
.pipelines/az-vote-pr-pipeline.yaml arc-cicd-demo-src PR adlı uygulama PR işlem hattı
.pipelines/az-vote-ci-pipeline.yaml arc-cicd-demo-src CI adlı uygulama CI işlem hattı
.pipelines/az-vote-cd-pipeline.yaml Arc-cicd-demo-src CD adlı uygulama CD işlem hattı

Azure Container Registry'yi Azure DevOps'a bağlama

CI işlemi sırasında, uygulama kapsayıcılarınızı bir kayıt defterine dağıtırsınız. Azure hizmet bağlantısı oluşturarak başlayın:

  1. Azure DevOps'ta, proje ayarları sayfasından Hizmet bağlantıları sayfasını açın. TFS'de, üst menü çubuğundaki ayarlar simgesinden Hizmetler sayfasını açın.
  2. + Yeni hizmet bağlantısı'nı seçin ve ihtiyacınız olan hizmet bağlantısı türünü seçin.
  3. Hizmet bağlantısı parametrelerini doldurun. Bu öğretici için:
    • Hizmet bağlantısını arc-demo-acr olarak adlandırın.
    • Kaynak grubu olarak myResourceGroup öğesini seçin.
  4. Tüm işlem hatlarına erişim izni ver'i seçin.
    • Bu seçenek YAML işlem hattı dosyalarını hizmet bağlantıları için yetkiler.
  5. Bağlantıyı oluşturmak için Tamam'ı seçin.

Çekme isteği hizmeti bağlantısını yapılandırma

CD işlem hattı GitOps deposundaki PR'leri işler. Bunu yapmak için bir hizmet bağlantısı gerekir. Bu bağlantıyı yapılandırmak için:

  1. Azure DevOps'ta, proje ayarları sayfasından Hizmet bağlantıları sayfasını açın. TFS'de, üst menü çubuğundaki ayarlar simgesinden Hizmetler sayfasını açın.
  2. + Yeni hizmet bağlantısı'nı seçin ve tür'e tıklayınGeneric.
  3. Hizmet bağlantısı parametrelerini doldurun. Bu öğretici için:
    • Sunucu URL'si https://dev.azure.com/<Your organization>/<Your project>/_apis/git/repositories/arc-cicd-demo-gitops
    • Kullanıcı Adı ve Parola'ı boş bırakın.
    • Hizmet bağlantısını azdo-pr-connection olarak adlandırın.
  4. Tüm işlem hatlarına erişim izni ver'i seçin.
    • Bu seçenek YAML işlem hattı dosyalarını hizmet bağlantıları için yetkiler.
  5. Bağlantıyı oluşturmak için Tamam'ı seçin.

GitOps Bağlayıcısı'nı yükleme

  1. Helm depolarına GitOps Bağlayıcısı deposu ekleyin:

       helm repo add gitops-connector https://azure.github.io/gitops-connector/

  2. Bağlayıcıyı kümeye yükleyin:

       helm upgrade -i gitops-connector gitops-connector/gitops-connector \
      --namespace flux-system \
      --set gitRepositoryType=AZDO \
      --set ciCdOrchestratorType=AZDO \
      --set gitOpsOperatorType=FLUX \
      --set azdoGitOpsRepoName=arc-cicd-demo-gitops \
      --set azdoOrgUrl=https://dev.azure.com/<Your organization>/<Your project> \
      --set gitOpsAppURL=https://dev.azure.com/<Your organization>/<Your project>/_git/arc-cicd-demo-gitops \
      --set orchestratorPAT=<Azure Repos PAT token>

    Not

    Azure Repos PAT tokenve Code: Full izinlerine sahip Build: Read & execute olmalıdır.

  3. Flux'u GitOps bağlayıcısına bildirim gönderecek şekilde yapılandırın:

    cat <<EOF | kubectl apply -f -
apiVersion: notification.toolkit.fluxcd.io/v1beta1
kind: Alert
metadata:
  name: gitops-connector
  namespace: flux-system
spec:
  eventSeverity: info
  eventSources:
  - kind: GitRepository
    name: cluster-config
  - kind: Kustomization
    name: cluster-config-cluster-config 
  providerRef:
    name: gitops-connector
---
apiVersion: notification.toolkit.fluxcd.io/v1beta1
kind: Provider
metadata:
  name: gitops-connector
  namespace: flux-system
spec:
  type: generic
  address: http://gitops-connector:8080/gitopsphase
EOF

Yüklemeyle ilgili ayrıntılar için GitOps Bağlayıcısı deposuna bakın.

Ortam değişkeni grupları oluşturma

Uygulama deposu değişken grubu

az-vote-app-dev adlı bir değişken grubu oluşturun. Aşağıdaki değerleri ayarlayın:

Değişken Değer
AZURE_SUBSCRIPTION (öğreticinin önceki bölümlerinden arc-demo-acr olması gereken Azure Hizmet Bağlantınız)
AZ_ACR_NAME Azure ACR adı, örneğin arc-demo-acr
ENVIRONMENT_NAME Geliştirme
MANIFESTS_BRANCH master
MANIFESTS_REPO arc-cicd-demo-gitops
ORGANIZATION_NAME Azure DevOps kuruluşunun adı
PROJECT_NAME Azure DevOps'ta GitOps projesinin adı
REPO_URL GitOps deposu için tam URL
SRC_FOLDER azure-vote
TARGET_CLUSTER arc-cicd-cluster
TARGET_NAMESPACE dev
VOTE_APP_TITLE Oylama Uygulaması
AKS_RESOURCE_GROUP AKS Kaynak grubu. Otomatik test için gereklidir.
AKS_NAME AKS Adı. Otomatik test için gereklidir.

Ortam değişken grubunu hazırlama

  1. az-vote-app-dev değişken grubunu kopyalama.
  2. Adı az-vote-app-stage olarak değiştirin.
  3. Karşılık gelen değişkenler için aşağıdaki değerlerin olduğundan emin olun:
Değişken Değer
ENVIRONMENT_NAME Aşama
TARGET_NAMESPACE stage

Artık ve stage ortamlarına dağıtmaya dev hazırsınız.

Ortamlar oluşturma

Azure DevOps projenizde ve Stage ortamları oluşturunDev. Ayrıntılar için bkz . Ortam oluşturma ve hedefleme.

Derleme hizmeti için daha fazla izin verme

CD işlem hattı, GitOps deposunda kimlik doğrulaması yapmak için çalışan derlemenin güvenlik belirtecini kullanır. İşlem hattının yeni bir dal oluşturması, değişiklikleri göndermesi ve çekme istekleri oluşturması için daha fazla izin gerekir.

  1. Project settings Azure DevOps projesi ana sayfasından adresine gidin.
  2. Repos/Repositories öğesini seçin.
  3. Security öğesini seçin.
  4. <Project Name> Build Service (<Organization Name>) ve için Project Collection Build Service (<Organization Name>) (görünmüyorsa arama alanına yazın), , Contribute to pull requestsve Create branchöğesine izin verinContribute.
  5. Şuraya gidin: Pipelines/Settings
  6. Protect access to repositories in YAML pipelines Kapat seçeneği

Daha fazla bilgi için bkz.

Geliştirme ortamını ilk kez dağıtma

CI ve CD işlem hatları oluşturulduktan sonra ci işlem hattını çalıştırarak uygulamayı ilk kez dağıtın.

CI işlem hattı

İlk CI işlem hattı çalıştırması sırasında, hizmet bağlantı adını okurken kaynak yetkilendirme hatası alabilirsiniz.

  1. Erişilen değişkenin AZURE_SUBSCRIPTION olduğunu doğrulayın.
  2. Kullanımı yetkilendirme.
  3. İşlem hattını yeniden çalıştırın.

CI işlem hattı:

  • Uygulama değişikliğinin dağıtım için tüm otomatik kalite denetimlerini geçmesini sağlar.
  • Çekme isteği işlem hattında tamamlanamadı fazladan doğrulama yapar.
    • GitOps'a özgü işlem hattı, CD işlem hattı tarafından dağıtılacak işleme için yapıtları da yayımlar.
  • Docker görüntüsünün değiştiğini ve yeni görüntünün gönderildiğini doğrular.

CD işlem hattı

İlk CD işlem hattı çalıştırması sırasında işlem hattına GitOps deposuna erişim vermeniz gerekir. İşlem hattının bir kaynağa erişmek için izin alması istendiğinde Görüntüle'yi seçin. Ardından, işlem hattının geçerli ve gelecekteki çalıştırmaları için GitOps deposunu kullanma izni vermek için İzin Ver'i seçin.

Başarılı CI işlem hattı çalıştırması, dağıtım işlemini tamamlamak için CD işlem hattını tetikler. Her ortama artımlı olarak dağıtacaksınız.

İpucu

CD işlem hattı otomatik olarak tetiklenmiyorsa:

  1. Adın içindeki dal tetikleyicisi ile eşleşti sini doğrulayın .pipelines/az-vote-cd-pipeline.yaml
    • arc-cicd-demo-src CI olmalıdır.
  2. CI işlem hattını yeniden çalıştırın.

Şablon ve bildirim GitOps deposunda değiştirildikten sonra, CD işlem hattı bir işleme oluşturur, gönderir ve onay için bir çekme isteği oluşturur.

  1. GitOps deposuna işlem hattı tarafından oluşturulan çekme isteğini bulun.

  2. GitOps deposundaki değişiklikleri doğrulayın. Şunu görmeniz gerekir:

    • Üst düzey Helm şablonu değişiklikleri.
    • İstenen durumda temel alınan değişiklikleri gösteren alt düzey Kubernetes bildirimleri. Flux bu bildirimleri dağıtır.

  3. Her şey iyi görünüyorsa pr'yi onaylayın ve tamamlayın.

  4. Birkaç dakika sonra Flux değişikliği alır ve dağıtımı başlatır.

  5. İşleme geçmişi sekmesinde Git İşleme durumunu izleyin. olduğunda succeeded, CD işlem hattı otomatik teste başlar.

  6. Bağlantı noktasını kullanarak kubectl yerel olarak iletin ve uygulamanın şu şekilde düzgün çalıştığından emin olun:

    kubectl port-forward -n dev svc/azure-vote-front 8080:80

  7. Tarayıcınızda Azure Vote uygulamasını adresinde http://localhost:8080/görüntüleyin.

  8. Sık kullanılanlarınıza oy verin ve uygulamada bazı değişiklikler yapmaya hazır olun.

Ortam onaylarını ayarlama

Uygulama dağıtımında yalnızca kod veya şablonlarda değişiklik yapmakla kalmaz, aynı zamanda istemeden kümeyi hatalı duruma getirebilirsiniz.

Geliştirme ortamı dağıtımdan sonra bir kesme gösterirse, ortam onaylarını kullanarak daha sonraki ortamlara gitmelerini engelleyin.

  1. Azure DevOps projenizde korunması gereken ortama gidin.
  2. Kaynak için Onaylar ve Denetimler'e gidin.
  3. Oluştur'u belirleyin.
  4. Onaylayanları ve isteğe bağlı bir iletiyi sağlayın.
  5. El ile onay denetiminin eklenmesini tamamlamak için Yeniden Oluştur'u seçin.

Daha fazla ayrıntı için Onay ve denetim tanımlama öğreticisine bakın.

CD işlem hattı bir sonraki çalıştırıldığında işlem hattı GitOps PR oluşturulduktan sonra duraklatılır. Değişikliğin düzgün eşitlendiğini ve temel işlevleri geçtiğini doğrulayın. Değişikliğin sonraki ortama akışına izin vermek için işlem hattından denetimi onaylayın.

Uygulama değişikliği yapma

Kümedeki durumu temsil eden bu temel şablon ve bildirim kümesiyle uygulamada küçük bir değişiklik yapacaksınız.

  1. arc-cicd-demo-src deposunda dosyayı düzenleyinazure-vote/src/azure-vote-front/config_file.cfg.

  2. "Cats vs Dogs" yeterli oy almadığından, oy sayısını artırmak için bunu "Sekmeler ve Boşluklar" olarak değiştirin.

  3. Değişikliği yeni bir dalda işleyin, gönderin ve bir çekme isteği oluşturun. Bu adım dizisi, CI/CD yaşam döngüsünü başlatan tipik geliştirici akışıdır.

Çekme isteği doğrulama işlem hattı

PR işlem hattı, hatalı bir değişikliğe karşı ilk savunma hattıdır. Normal uygulama kodu kalite denetimleri lint ve statik analiz içerir. GitOps perspektifinden bakıldığında, sonuçta elde edilen altyapının dağıtılması için de aynı kaliteyi güvenceye almanız gerekir.

Uygulamanın Dockerfile ve Helm grafikleri, uygulamaya benzer şekilde lint özelliğini kullanabilir.

Yanlış biçimlendirilmiş YAML dosyalarından uygulamanız için CPU ve Bellek sınırları ayarlama gibi en iyi yöntem önerilerine kadar lint aralığı sırasında bulunan hatalar.

Not

Gerçek bir uygulamada Helm linting'den en iyi kapsamı elde etmek için, gerçek bir ortamda kullanılanlara makul ölçüde benzeyen değerleri değiştirmeniz gerekir.

İşlem hattı yürütme sırasında bulunan hatalar çalıştırmanın test sonuçları bölümünde görünür. Buradan, şunları yapabilirsiniz:

  • Hata türleriyle ilgili yararlı istatistikleri izleyin.
  • Algılandıkları ilk işlemeyi bulun.
  • Yığın izleme stili, hataya neden olan kod bölümlerine bağlanır.

İşlem hattı çalıştırması tamamlandıktan sonra, uygulama kodunun ve bunu dağıtan şablonun kalitesini garanti etmiş olursunuz. Artık çekme isteğini onaylayabilir ve tamamlayabilirsiniz. CI, CD işlem hattını tetiklemeden önce şablonları ve bildirimleri yeniden düzenleyerek yeniden çalışır.

İpucu

Gerçek bir ortamda, çekme isteğinin kalite denetimlerinizi geçtiğinden emin olmak için dal ilkeleri ayarlamayı unutmayın. Daha fazla bilgi için bkz . Dal ilkelerini ayarlama.

CD işlemi onayları

Başarılı bir CI işlem hattı çalıştırması, dağıtım işlemini tamamlamak için CD işlem hattını tetikler. Bu kez işlem hattı her dağıtım ortamını onaylamanızı gerektirir.

  1. Ortama dağıtımı dev onaylayın.
  2. Şablon ve bildirim GitOps deposunda değiştirildikten sonra, CD işlem hattı bir işleme oluşturur, gönderir ve onay için bir çekme isteği oluşturur.
  3. GitOps deposundaki değişiklikleri doğrulayın. Şunu görmeniz gerekir:
    • Üst düzey Helm şablonu değişiklikleri.
    • İstenen durumda temel alınan değişiklikleri gösteren alt düzey Kubernetes bildirimleri.
  4. Her şey iyi görünüyorsa pr'yi onaylayın ve tamamlayın.
  5. Dağıtımın tamamlanmasını bekleyin.
  6. Temel duman testi olarak, uygulama sayfasına gidin ve oylama uygulamasının artık Sekmeler ve Alanlar'ın görüntülendiğini doğrulayın.
    • Bağlantı noktasını kullanarak kubectl yerel olarak iletin ve uygulamanın şu şekilde düzgün çalıştığından emin olun: kubectl port-forward -n dev svc/azure-vote-front 8080:80
    • Adresinden tarayıcınızda http://localhost:8080/ Azure Vote uygulamasını görüntüleyin ve oylama seçeneklerinin Sekmeler ve Alanlar olarak değiştiğini doğrulayın.
  7. Ortam için stage 1-7 arası adımları yineleyin.

Dağıtım tamamlandı.

Bu öğreticide kullanılan CI/CD iş akışlarında uygulanan tüm adım ve tekniklere ayrıntılı bir genel bakış için bkz . Azure DevOps GitOps Flow diyagramı.

GitHub ile CI/CD uygulama

Bu öğreticide GitHub, GitHub Actions hakkında bilgi sahibi olduğunuz varsayılır.

Çatal uygulaması ve GitOps depoları

Uygulama deposu ve GitOps deposu çatalı oluşturun. Bu öğretici için aşağıdaki örnek depoları kullanın:

GitOps deposunu bağlama

Uygulamanızı sürekli dağıtmak için GitOps kullanarak uygulama deposunu kümenize bağlayın. arc-cicd-demo-gitops GitOps deponuz, arc-cicd-cluster kümenizde uygulamanızı çalışır duruma getirmek için temel kaynakları içerir.

İlk GitOps deposu yalnızca dağıtım ortamlarına karşılık gelen geliştirme ve aşama ad alanlarını oluşturan bir bildirim içerir.

Oluşturduğunuz GitOps bağlantısı otomatik olarak:

  • Bildirim dizinindeki bildirimleri eşitleyin.
  • Küme durumunu güncelleştirin.

CI/CD iş akışı, uygulamayı dağıtmak için bildirim dizinini ek bildirimlerle doldurur.

  1. GitHub'da yeni çatallanan arc-cicd-demo-gitops deponuza yeni bir GitOps bağlantısı oluşturun.

    az k8s-configuration flux create \
   --name cluster-config \
   --cluster-name arc-cicd-cluster \
   --namespace cluster-config \
   --resource-group myResourceGroup \
   -u  https://github.com/<Your organization>/arc-cicd-demo-gitops.git \
   --https-user <Azure Repos username> \
   --https-key <Azure Repos PAT token> \
   --scope cluster \
   --cluster-type connectedClusters \
   --branch master \
   --kustomization name=cluster-config prune=true path=arc-cicd-cluster/manifests

  2. Azure portalında dağıtımın durumunu denetleyin.

    • Başarılı olursa kümenizde hem hem de devstage ad alanlarının oluşturulduğunu görürsünüz.

GitOps Bağlayıcısı'nı yükleme

  1. Helm depolarına GitOps Bağlayıcısı deposu ekleyin:

       helm repo add gitops-connector https://azure.github.io/gitops-connector/

  2. Bağlayıcıyı kümeye yükleyin:

       helm upgrade -i gitops-connector gitops-connector/gitops-connector \
      --namespace flux-system \
      --set gitRepositoryType=GITHUB \
      --set ciCdOrchestratorType=GITHUB \
      --set gitOpsOperatorType=FLUX \
      --set gitHubGitOpsRepoName=arc-cicd-demo-src \
      --set gitHubGitOpsManifestsRepoName=arc-cicd-demo-gitops \
      --set gitHubOrgUrl=https://api.github.com/repos/<Your organization> \
      --set gitOpsAppURL=https://github.com/<Your organization>/arc-cicd-demo-gitops/commit \
      --set orchestratorPAT=<GitHub PAT token>

  3. Flux'u GitOps bağlayıcısına bildirim gönderecek şekilde yapılandırın:

    cat <<EOF | kubectl apply -f -
apiVersion: notification.toolkit.fluxcd.io/v1beta1
kind: Alert
metadata:
  name: gitops-connector
  namespace: flux-system
spec:
  eventSeverity: info
  eventSources:
  - kind: GitRepository
    name: cluster-config
  - kind: Kustomization
    name: cluster-config-cluster-config
  providerRef:
    name: gitops-connector
---
apiVersion: notification.toolkit.fluxcd.io/v1beta1
kind: Provider
metadata:
  name: gitops-connector
  namespace: flux-system
spec:
  type: generic
  address: http://gitops-connector:8080/gitopsphase
EOF

Yüklemeyle ilgili ayrıntılar için GitOps Bağlayıcısı deposuna bakın.

GitHub gizli dizileri oluşturma

GitHub depo gizli dizileri oluşturma

Gizli dizi Değer
AZURE_CREDENTIALS Azure kimlik bilgileri şu biçimde {"clientId":"GUID","clientSecret":"GUID","subscriptionId":"GUID","tenantId":"GUID"}
AZ_ACR_NAME Azure ACR adı, örneğin arc-demo-acr
MANIFESTS_BRANCH master
MANIFESTS_FOLDER arc-cicd-cluster
MANIFESTS_REPO https://github.com/your-organization/arc-cicd-demo-gitops
VOTE_APP_TITLE Oylama Uygulaması
AKS_RESOURCE_GROUP AKS Kaynak grubu. Otomatik test için gereklidir.
AKS_NAME AKS Adı. Otomatik test için gereklidir.
PAT GitOps deposuna çekme isteği iznine sahip GitHub PAT belirteci

GitHub ortam gizli dizileri oluşturma

  1. Aşağıdaki gizli dizilerle ortam oluşturun az-vote-app-dev :
Gizli dizi Değer
ENVIRONMENT_NAME Geliştirme
TARGET_NAMESPACE dev
  1. Aşağıdaki gizli dizilerle ortam oluşturun az-vote-app-stage :
Gizli dizi Değer
ENVIRONMENT_NAME Aşama
TARGET_NAMESPACE stage

Artık ve stage ortamlarına dağıtmaya dev hazırsınız.

CI/CD Geliştirme iş akışı

CI/CD Geliştirme iş akışını başlatmak için kaynak kodu değiştirin. Uygulama deposunda, dosyadaki .azure-vote/src/azure-vote-front/config_file.cfg değerleri güncelleştirin ve değişiklikleri depoya gönderin.

CI/CD Geliştirme iş akışı:

  • Uygulama değişikliğinin dağıtım için tüm otomatik kalite denetimlerini geçmesini sağlar.
  • Çekme isteği işlem hattında tamamlanamadı fazladan doğrulama yapar.
  • Docker görüntüsünün değiştiğini ve yeni görüntünün gönderildiğini doğrular.
  • Aşağıdaki CD aşamaları tarafından kullanılacak yapıtları (Docker görüntü etiketleri, Bildirim şablonları, Yardımcı Programlar) yayımlar.
  • Uygulamayı Geliştirme ortamına dağıtır.
    • GitOps deposuna bildirimler oluşturur.
    • Onay için GitOps deposuna bir çekme isteği oluşturur.

  1. GitOps deposuna işlem hattı tarafından oluşturulan çekme isteğini bulun.

  2. GitOps deposundaki değişiklikleri doğrulayın. Şunu görmeniz gerekir:

    • Üst düzey Helm şablonu değişiklikleri.
    • İstenen durumda temel alınan değişiklikleri gösteren alt düzey Kubernetes bildirimleri. Flux bu bildirimleri dağıtır.

  3. Her şey iyi görünüyorsa pr'yi onaylayın ve tamamlayın.

  4. Birkaç dakika sonra Flux değişikliği alır ve dağıtımı başlatır.

  5. İşleme geçmişi sekmesinde Git İşleme durumunu izleyin. olduğunda succeedediş CD Stage akışı başlatılır.

  6. Bağlantı noktasını kullanarak kubectl yerel olarak iletin ve uygulamanın şu şekilde düzgün çalıştığından emin olun:

    kubectl port-forward -n dev svc/azure-vote-front 8080:80

  7. Tarayıcınızda Azure Vote uygulamasını adresinde http://localhost:8080/görüntüleyin.

  8. Sık kullanılanlarınıza oy verin ve uygulamada bazı değişiklikler yapmaya hazır olun.

CD Stage iş akışı

CD Stage iş akışı, Flux uygulamayı geliştirme ortamına başarıyla dağıttığı ve GitOps Bağlayıcısı aracılığıyla GitHub eylemlerini bilgilendirdiği zaman otomatik olarak başlatılır.

CD Stage iş akışı:

  • Geliştirme ortamına karşı uygulama duman testleri çalıştırır
  • Uygulamayı Stage ortamına dağıtır.
    • GitOps deposunda bildirimler oluşturur
    • Onay için GitOps deposuna bir çekme isteği oluşturur

Çekme isteğini Aşama ortamına bildirir ve Flux tüm değişiklikleri başarıyla uygularsa GitOps deposunda Git işleme durumu güncelleştirilir. Dağıtım tamamlandı.

Bu öğreticide kullanılan CI/CD iş akışlarında uygulanan tüm adım ve tekniklere ayrıntılı bir genel bakış için GitHub GitOps Flow diyagramına bakın.

Kaynakları temizleme

Bu uygulamayı kullanmaya devam etmeyecekseniz aşağıdaki adımlarla tüm kaynakları silin:

  1. Azure Arc GitOps yapılandırma bağlantısını silin:

    az k8s-configuration flux delete \
      --name cluster-config \
      --cluster-name arc-cicd-cluster \
      --resource-group myResourceGroup \
      -t connectedClusters --yes

  2. GitOps Bağlayıcısı'nı sil:

    helm uninstall gitops-connector -n flux-system
kubectl delete alerts.notification.toolkit.fluxcd.io gitops-connector -n flux-system
kubectl delete providers.notification.toolkit.fluxcd.io  gitops-connector -n flux-system

Sonraki adımlar

Bu öğreticide, dağıtım aracılığıyla uygulama geliştirmeden DevOps uygulayan tam bir CI/CD iş akışı ayarladınız. Uygulamada yapılan değişiklikler, doğrulama ve dağıtımı otomatik olarak tetikler ve el ile onaylarla geçitlendirilir.

Azure Arc özellikli Kubernetes ile GitOps ve yapılandırmalar hakkında daha fazla bilgi edinmek için kavramsal makalemize ilerleyin.

Kavram: GitOps Örnek uygulaması ile CD işlemi: GitOpsile CI/CD akışını keşfetme