Öğretici: Jenkins derleme aracısı olarak Azure Container Instances kullanma

Önemli

Birçok Azure hizmeti Jenkins eklentilerine sahiptir. Bu eklentilerden bazıları 29 Şubat 2024 itibarıyla destekten çıkarılacaktır. Azure CLI, Jenkins'i Azure hizmetleriyle tümleştirmenin şu anda önerilen yoludur. Daha fazla bilgi için Azure için Jenkins eklentileri makalesine bakın.

Azure Container Instances (ACI), kapsayıcılı iş yüklerini çalıştırmak için isteğe bağlı, seri hale getirilebilir ve yalıtılmış bir ortam sağlar. Bu öznitelikler nedeniyle ACI, Jenkins derleme işlerini büyük ölçekte çalıştırmak için harika bir platform oluşturur. Bu makalede, bir ACI'nin nasıl dağıtılacağı ve Jenkins denetleyicisi için kalıcı derleme aracısı olarak nasıl ekleneceği gösterilmektedir.

Azure Container Instances hakkında daha fazla bilgi için bkz . Azure Container Instances hakkında.

Önkoşullar

  • Azure aboneliği: Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.
  • Jenkins sunucusu: Yüklü bir Jenkins sunucunuz yoksa Azure'da bir Jenkins sunucusu oluşturun.

Jenkins denetleyicisini hazırlama

  1. Jenkins portalınıza göz atın.

  2. Menüden Jenkins'i Yönet'i seçin.

  3. Sistem Yapılandırması'nın altında Sistemi Yapılandır'ı seçin.

  4. Jenkins URL'sinin Jenkins yüklemenizin HTTP adresine ayarlandığını doğrulayın- http://<your_host>.<your_domain>:8080/.

  5. Menüden Jenkins'i Yönet'i seçin.

  6. Güvenlik'in altında Genel Güvenliği Yapılandır'ı seçin.

  7. Aracılar'ın altında Sabit bağlantı noktası'nı belirtin ve ortamınız için uygun bağlantı noktası numarasını girin.

    Yapılandırma örneği: Configure TCP port

  8. Kaydet'i seçin.

Jenkins iş aracısı oluşturma

  1. Jenkins portalınıza göz atın.

  2. Menüden Jenkins'i Yönet'i seçin.

  3. Sistem Yapılandırması'nın altında Düğümleri ve Bulutları Yönet'i seçin.

  4. Menüden Yeni Düğüm'e tıklayın.

  5. Düğüm Adı için bir değer girin.

  6. Kalıcı Aracı'ya tıklayın.

  7. Tamam seçeneğini işaretleyin.

  8. Uzak kök dizin için bir değer girin. Örneğin /home/jenkins/work

  9. Etiket Ekleme (Etiketler, birden çok aracıyı tek bir mantıksal grupta gruplandırmak için kullanılır. Bir etikete örnek olarak Linux aracılarınızı gruplandırmak gerekirlinux.) değeriylelinux.

  10. Ana sunucuya bağlanarak Başlatma yöntemini Aracıyı başlat olarak ayarlayın.

  11. Tüm gerekli alanların belirtildiğini veya girildiğini doğrulayın:

    Example Jenkins agent configuration

  12. Kaydet'i seçin.

  13. Aracı durumu sayfasında ve AGENT_NAMEifadesini JENKINS_SECRET görmeniz gerekir. Aşağıdaki ekran görüntüsünde değerlerin nasıl tanımlayacakları gösterilmektedir. Azure Container Instance'ını oluştururken her iki değer de gereklidir.

    The build-agent secret is displays after its successful creation.

CLI ile Azure Container Instance oluşturma

  1. Azure kaynak grubu oluşturmak için az group create komutunu kullanın.

    az group create --name my-resourcegroup --location westus
    
  2. Azure Container Instance oluşturmak için az container create komutunu kullanın. Yer tutucuları, iş aracısını oluştururken elde edilen değerlerle değiştirin.

    az container create \
      --name my-dock \
      --resource-group my-resourcegroup \
      --ip-address Public --image jenkins/inbound-agent:latest \
      --os-type linux \
      --ports 80 \
      --command-line "jenkins-agent -url http://jenkinsserver:port <JENKINS_SECRET> <AGENT_NAME>"
    

    , <JENKINS_SECRET>ve <AGENT_NAME> değerini Jenkins denetleyicinizle ve aracı bilgilerinizle değiştirinhttp://jenkinsserver:port. Kapsayıcı başlatıldıktan sonra Jenkins denetleyici sunucusuna otomatik olarak bağlanır.

  3. Jenkins panosuna dönün ve aracı durumunu denetleyin.

    Agent has started successfully

    Dekont

    Jenkins aracıları, bağlantı noktası 5000üzerinden denetleyiciye bağlanır. Jenkins Denetleyicisi'ne gelen bağlantı noktasına izin verildiğinden emin olun.

Derleme işi oluşturma

Şimdi, Bir Azure kapsayıcı örneğinde Jenkins derlemelerini göstermek için bir Jenkins derleme işi oluşturulur.

  1. Yeni Öğe'yi seçin, derleme projesine aci-demo gibi bir ad verin, Serbest stil projesi'ni seçin ve Tamam'ı seçin.

    Box for the name of the build job, and list of project types

  2. Genel'in altında, Bu projenin çalıştırılacağı yeri kısıtla'nın seçili olduğundan emin olun. Etiket ifadesi için linux girin. Bu yapılandırma, bu derleme işinin ACI bulutu üzerinde çalışmasını sağlar.

  3. Derleme'nin altında Derleme adımı ekle'yi ve ardından Kabuğu Yürüt'e tıklayın. Komut olarak girin echo "aci-demo" .

  4. Kaydet'i seçin.

Derleme işini çalıştırma

Derleme işini test etmek ve Azure Container Instances'ın derlemeyi el ile başlatmasını gözlemlemek için.

  1. Derleme işini başlatmak için Şimdi Derle'yi seçin. İş başladıktan sonra aşağıdaki görüntüye benzer bir durum görürsünüz:

  2. Derleme Geçmişi'nde derleme 1'etıklayın.

  3. Derleme çıkışını görüntülemek için Konsol Çıkışı'nı seçin.

Sonraki adımlar