Azure portalından Azure Linux VM'de bir Jenkins sunucusu oluşturmaCreate a Jenkins server on an Azure Linux VM from the Azure portal

Bu hızlı başlangıç, Ubuntu Linux VM'de araçları ve eklentileri Azure ile çalışmak için yapılandırılmış Jenkins’in nasıl yükleneceğini gösterir.This quickstart shows how to install Jenkins on an Ubuntu Linux VM with the tools and plug-ins configured to work with Azure. İşlemi tamamladığınızda, Azure‘da çalışan bir Jenkins sunucusuna sahip ve GitHub’dan örnek bir Java uygulaması oluşturmuş olursunuz.When you're finished, you have a Jenkins server running in Azure building a sample Java app from GitHub.

ÖnkoşullarPrerequisites

  • Bir Azure aboneliğiAn Azure subscription
  • Bilgisayarınızın komut satırından (Bash kabuğu veya PuTTY gibi) SSH’ye erişin.Access to SSH on your computer's command line (such as the Bash shell or PuTTY)

Yoksa bir Azure aboneliği, oluşturun bir ücretsiz bir hesap başlamadan önce.If you don't have an Azure subscription, create a free account before you begin.

Çözüm şablonundan Jenkins VM’si oluşturmaCreate the Jenkins VM from the solution template

Jenkins, tek bir Jenkins yüklemesinin çok sayıda projeyi barındırması veya derleme ya da test için gereken farklı ortamları sağlamak için Jenkins sunucusunun işi bir veya daha fazla aracıya devrettiği bir modeli destekler.Jenkins supports a model where the Jenkins server delegates work to one or more agents to allow a single Jenkins installation to host a large number of projects or to provide different environments needed for builds or tests. Bu bölümdeki adımlar Azure'da Jenkins sunucusu yükleme ve yapılandırma aşamasında size yol gösterir.The steps in this section guide you through installing and configuring a Jenkins server on Azure.

  1. Tarayıcınızda açın Jenkins için Azure Market görüntüsü.In your browser, open the Azure Marketplace image for Jenkins.

  2. Seçin alma şimdi.Select GET IT NOW.

    Jenkins Market görüntüsü için yükleme işlemini başlatmak için artık GIT BT'yi seçin.

  3. Fiyatlandırma ayrıntıları ve koşulları bilgileri gözden geçirdikten sonra seçin devam.After reviewing the pricing details and terms information, select Continue.

    Jenkins Market görüntü fiyatlandırması ve koşulları bilgileri.

  4. Seçin Oluştur Azure portalında Jenkins sunucusunu yapılandırmak için.Select Create to configure the Jenkins server in the Azure portal.

    Jenkins Market görüntüsü yükleyin.

  5. İçinde Temelleri sekmesinde, aşağıdaki değerleri belirtin:In the Basics tab, specify the following values:

    • Adı -girin Jenkins.Name - Enter Jenkins.

    • Kullanıcı adı -Jenkins üzerinde çalıştığı sanal makineye oturum açarken kullanılacak kullanıcı adını girin.User name - Enter the user name to use when signing in to the virtual machine on which Jenkins is running. Kullanıcı adı belirli gereksinimleri karşılamalıdır.The user name must meet specific requirements.

    • Kimlik doğrulama türü - seçin SSH ortak anahtarı.Authentication type - Select SSH public key.

    • SSH ortak anahtarı -kopyalama ve yapıştırma RSA ortak anahtarını tek satırlı biçimde (başlayarak ssh-rsa) veya çok satırlı PEM biçimi.SSH public key - Copy and paste an RSA public key in single-line format (starting with ssh-rsa) or multi-line PEM format. Ssh-keygen Linux ve macOS veya Windows üzerinde puttygen araçlarını kullanarak SSH anahtarları oluşturabilirsiniz.You can generate SSH keys using ssh-keygen on Linux and macOS, or PuTTYGen on Windows. SSH anahtarları ve Azure hakkında daha fazla bilgi için bkz azure'da Windows ile SSH anahtarlarını kullanma nasıl.For more information about SSH keys and Azure, see the article, How to Use SSH keys with Windows on Azure.

    • Abonelik -Jenkins yüklemek istediğiniz Azure aboneliğini seçin.Subscription - Select the Azure subscription into which you want to install Jenkins.

    • Kaynak grubu - seçin Yeni Oluştur, Jenkins yüklemenizin olun kaynak koleksiyonu için mantıksal kapsayıcı görevi gören bir kaynak grubu için bir ad girin.Resource group - Select Create new, and enter a name for the resource group that serves as a logical container for the collection of resources that make up your Jenkins installation.

    • Konum - seçin Doğu ABD.Location - Select East US.

      Jenkins için kimlik doğrulama ve kaynak grubu bilgileri temel sekmede girin.

  6. Seçin Tamam geçmek için ek ayarlar sekmesi.Select OK to proceed to the Additional Settings tab.

  7. İçinde ek ayarlar sekmesinde, aşağıdaki değerleri belirtin:In the Additional Settings tab, specify the following values:

    • Boyutu -Jenkins sanal makineniz için uygun boyutlandırma seçeneğini belirleyin.Size - Select the appropriate sizing option for your Jenkins virtual machine.

    • VM disk türü - ya da HDD (sabit disk sürücüsü) belirtin veya Jenkins sanal makinesi için hangi depolama disk türüne belirtmek için SSD (katı hal sürücüsü) izin verilir.VM disk type - Specify either HDD (hard-disk drive) or SSD (solid-state drive) to indicate which storage disk type is allowed for the Jenkins virtual machine.

    • Sanal ağ -(isteğe bağlı) seçin sanal ağ varsayılan ayarlarını değiştirmek için.Virtual network - (Optional) Select Virtual network to modify the default settings.

    • Alt ağlar - seçin alt ağlarbilgileri doğrulayın ve seçin Tamam.Subnets - Select Subnets, verify the information, and select OK.

    • Genel IP adresi -IP adresi adı varsayılan olarak bir sonek - IP önceki sayfada belirtilen Jenkins adı.Public IP address - The IP address name defaults to the Jenkins name you specified in the previous page with a suffix of -IP. Bu varsayılanı değiştirmek için seçeneğini kullanabilirsiniz.You can select the option to change that default.

    • Etki alanı adı etiketi -Jenkins sanal makinesi için tam URL değeri belirtin.Domain name label - Specify the value for the fully qualified URL to the Jenkins virtual machine.

    • Jenkins yayın türünü -istenen sürüm türü seçenekleri: LTS, Weekly build, veya Azure Verified.Jenkins release type - Select the desired release type from the options: LTS, Weekly build, or Azure Verified. LTS Ve Weekly build seçenekleri makalesinde açıklanan Jenkins LTS yayın satırı.The LTS and Weekly build options are explained in the article, Jenkins LTS Release Line. Azure Verified Seçeneği başvurduğu bir Jenkins LTS sürümünü Azure'da çalışmak üzere doğrulandı.The Azure Verified option refers to a Jenkins LTS version that has been verified to run on Azure.

    • JDK türü -JDK yüklenecek.JDK Type - JDK to be installed. Zulu test edilmiş, sertifikalı derlemelerini OpenJDK varsayılandır.Default is Zulu tested, certified builds of OpenJDK.

      Ayarlar sekmesinde Jenkins için sanal makine ayarlarını girin.

  8. Seçin Tamam geçmek için Tümleştirme ayarlarını sekmesi.Select OK to proceed to the Integration Settings tab.

  9. İçinde Tümleştirme ayarlarını sekmesinde, aşağıdaki değerleri belirtin:In the Integration Settings tab, specify the following values:

    • Hizmet sorumlusu -hizmet sorumlusu, Jenkins ile Azure ile kimlik doğrulaması için bir kimlik bilgisi olarak eklenir.Service Principal - The service principal is added into Jenkins as a credential for authentication with Azure. Auto Asıl MSI (yönetilen hizmet kimliği) tarafından oluşturulan anlamına gelir.Auto means that the principal will be created by MSI (Managed Service Identity). Manual Asıl sizin tarafınızdan oluşturulması gerektiğini anlamına gelir.Manual means that the principal should be created by you.
      • Uygulama Kimliği ve gizli - seçerseniz Manual seçeneğini hizmet sorumlusu seçeneğini belirtmeniz gerekir Application ID ve Secret için Hizmet sorumlusu.Application ID and Secret - If you select the Manual option for the Service Principal option, you'll need to specify the Application ID and Secret for your service principal. Zaman bir hizmet sorumlusu oluşturma, varsayılan rolü Not katkıda bulunan, Azure kaynaklarıyla çalışmak için yeterli olduğu.When creating a service principal, note that the default role is Contributor, which is sufficient for working with Azure resources.
    • Bulut aracıları etkinleştirmek -için aracıları varsayılan bulut şablonu belirtin burada ACI Azure Container Instance için ifade eder ve VM sanal makinelere ifade eder.Enable Cloud Agents - Specify the default cloud template for agents where ACI refers to Azure Container Instance, and VM refers to virtual machines. Ayrıca belirtebileceğiniz No bulut Aracısını etkinleştirmek istemiyorsanız.You can also specify No if you don't wish to enable a cloud agent.
  10. Seçin Tamam geçmek için özeti sekmesi.Select OK to proceed to the Summary tab.

  11. Zaman özeti sekmesini görüntüler, girdiğiniz bilgileri doğrulandı.When the Summary tab displays, the information entered is validated. Gördüğünüzde doğrulama başarılı seçin (sekmenin en üstündeki), ileti Tamam.Once you see the Validation passed message (at the top of the tab), select OK.

    Özet sekmesi, görüntüler ve seçili seçeneklerinizi doğrular.

  12. Zaman Oluştur sekmesini görüntüler, seçin Oluştur Jenkins sanal makinesi oluşturmak için.When the Create tab displays, select Create to create the Jenkins virtual machine. Sunucunuz hazır olduğunda, Azure portalında bir bildirim görüntülenir.When your server is ready, a notification displays in the Azure portal.

    Jenkins hazır bildirimidir.

Jenkins’e bağlanmaConnect to Jenkins

Web tarayıcınızda sanal makinenize (örneğin, http://jenkins2517454.eastus.cloudapp.azure.com/)) gidin.Navigate to your virtual machine (for example, http://jenkins2517454.eastus.cloudapp.azure.com/) in your web browser. Jenkins konsoluna güvenli olmayan HTTP üzerinden erişilemeyeceğinden Jenkins konsoluna bilgisayarınızdan SSH tüneli kullanarak güvenli bir şekilde erişmek için yönergeler bu sayfada sağlanmıştır.The Jenkins console is inaccessible through unsecured HTTP so instructions are provided on the page to access the Jenkins console securely from your computer using an SSH tunnel.

Jenkins’in kilidini açma

Komut satırından ssh komutunu kullanarak tüneli ayarlayın. username değerini çözüm şablonundan sanal makineyi ayarlarken seçtiğiniz sanal makine yönetici kullanıcısının adıyla değiştirin.Set up the tunnel using the ssh command on the page from the command line, replacing username with the name of the virtual machine admin user chosen earlier when setting up the virtual machine from the solution template.

ssh -L 127.0.0.1:8080:localhost:8080 jenkinsadmin@jenkins2517454.eastus.cloudapp.azure.com

Tüneli başlattıktan sonra, yerel makinenizde http://localhost:8080/ adresine gidin.After you have started the tunnel, navigate to http://localhost:8080/ on your local machine.

İlk parolayı Jenkins VM’ye SSH üzerinden bağlanırken bir komut satırında aşağıdaki komutu çalıştırarak alın.Get the initial password by running the following command in the command line while connected through SSH to the Jenkins VM.

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Bu ilk yönetici parolasıyla Jenkins panosunun kilidini ilk kez açın.Unlock the Jenkins dashboard for the first time using this initial password.

Jenkins’in kilidini açma

Sonraki sayfada Önerilen eklentileri yükle’yi seçin ve Jenkins panosuna erişmek için kullanılacak bir Jenkins yönetici kullanıcısı oluşturun.Select Install suggested plugins on the next page and then create a Jenkins admin user used to access the Jenkins dashboard.

Jenkins hazır!

Jenkins sunucusu artık kod oluşturmak için hazırdır.The Jenkins server is now ready to build code.

İlk işinizi oluşturmaCreate your first job

Jenkins konsolundan Yeni iş oluştur’u seçin, ardından işi mySampleApp olarak adlandırıp Serbest tarzda projeseçeneğini belirleyin ve Tamam’ı seçin.Select Create new jobs from the Jenkins console, then name it mySampleApp and select Freestyle project, then select OK.

Yeni bir iş oluşturma

Kaynak Kod Yönetimi sekmesini seçin, Git’i etkinleştirin ve Depo URL'si alanına aşağıdaki URL'yi girin :https://github.com/spring-guides/gs-spring-boot.gitSelect the Source Code Management tab, enable Git, and enter the following URL in Repository URL field: https://github.com/spring-guides/gs-spring-boot.git

Git deposunu tanımlayın

Yapı sekmesini ve ardından Yapı ekleme adımı’nı ve Gradle betiğini başlat’ı seçin.Select the Build tab, then select Add build step, Invoke Gradle script. Gradle sarmalayıcıyı kullan’ı seçin, ardından Sarmalayıcı konumu’na complete değerini, Görevler için build değerini girin.Select Use Gradle Wrapper, then enter complete in Wrapper location and build for Tasks.

Derlemek için Gradle sarmalayıcıyı kullanma

Advanced'i (Gelişmiş) seçin ve Root Build script (Kök Derleme betiği) alanına complete değerini girin.Select Advanced and then enter complete in the Root Build script field. Kaydet’i seçin.Select Save.

Gradle sarmalayıcısı derleme adımında Gelişmiş ayarları belirleme

Kodu oluşturmaBuild the code

Kodu derlemek ve örnek uygulamayı paketlemek için Şimdi Derle’yi seçin.Select Build Now to compile the code and package the sample app. Yapınız tamamlandığında proje için Çalışma alanı bağlantısını seçin.When your build completes, select the Workspace link for the project.

Derlemeden JAR dosyasını almak için çalışma alanına göz atma

Yapınızın başarılı olduğunu doğrulamak için complete/build/libs konumuna gidin ve gs-spring-boot-0.1.0.jar dosyasının olduğundan emin olun.Navigate to complete/build/libs and ensure the gs-spring-boot-0.1.0.jar is there to verify that your build was successful. Jenkins sunucunuz artık Azure’da projelerinizi derlemeye hazırdır.Your Jenkins server is now ready to build your own projects in Azure.

Jenkins çözüm şablonunu sorunlarını gidermeTroubleshooting the Jenkins solution template

Jenkins çözüm şablonuyla ilgili hatalarla karşılaşırsanız Jenkins GitHub deposunda sorun bildirin.If you encounter any bugs with the Jenkins solution template, file an issue in the Jenkins GitHub repo.

Sonraki AdımlarNext Steps