Skip to content

Latest commit

 

History

History
70 lines (48 loc) · 5.29 KB

jenkins-install-from-azure-marketplace-image.md

File metadata and controls

70 lines (48 loc) · 5.29 KB
description author manager ms.service ms.workload ms.devlang ms.topic ms.date ms.author ms.custom
include file
tomarcher
rloutlaw
multiple
web
na
include
03/12/2018
tarcher
Jenkins

  1. In your browser, open the Azure Marketplace image for Jenkins.

  2. Select GET IT NOW.

    Select GIT IT NOW to start the installation process for the Jenkins Marketplace image.

  3. After reviewing the pricing details and terms information, select Continue.

    Jenkins Marketplace image pricing and terms information.

  4. Select Create to configure the Jenkins server in the Azure portal.

    Install the Jenkins Marketplace image.

  5. In the Basics tab, specify the following values:

    • Name - Enter Jenkins.
    • User name - Enter the user name to use when signing in to the virtual machine on which Jenkins is running. The user name must meet specific requirements.
    • Authentication type - Select SSH public key.
    • SSH public key - Copy and paste an RSA public key in single-line format (starting with ssh-rsa) or multi-line PEM format. You can generate SSH keys using ssh-keygen on Linux and macOS, or PuTTYGen on Windows. For more information about SSH keys and Azure, see the article, How to Use SSH keys with Windows on Azure.
    • Subscription - Select the Azure subscription into which you want to install Jenkins.
    • 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.
    • Location - Select East US.

    Enter authentication and resource group information for Jenkins in the Basic tab.

  6. Select OK to proceed to the Additional Settings tab.

  7. In the Additional Settings tab, specify the following values:

    • Size - Select the appropriate sizing option for your Jenkins virtual machine.
    • 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.
    • Virtual network - (Optional) Select Virtual network to modify the default settings.
    • Subnets - Select Subnets, verify the information, and select OK.
    • Public IP address - The IP address name defaults to the Jenkins name you specified in the previous page with a suffix of -IP. You can select the option to change that default.
    • Domain name label - Specify the value for the fully qualified URL to the Jenkins virtual machine.
    • Jenkins release type - Select the desired release type from the options: LTS, Weekly build, or Azure Verified. The LTS and Weekly build options are explained in the article, Jenkins LTS Release Line. The Azure Verified option refers to a Jenkins LTS version that has been verified to run on Azure.

    Enter virtual machine settings for Jenkins in the Settings tab.

  8. Select OK to proceed to the Integration Settings tab.

  9. In the Integration Settings tab, specify the following values:

    • Service Principal - The service principal is added into Jenkins as a credential for authentication with Azure. Auto means that the principal will be created by MSI (Managed Service Identity). Manual means that the principal should be created by you.
      • 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. When creating a service principal, note that the default role is Contributor, which is sufficient for working with Azure resources.
    • Enable Cloud Agents - Specify the default cloud template for agents where ACI refers to Azure Container Instance, and VM refers to virtual machines. You can also specify No if you don't wish to enable a cloud agent.

  10. Select OK to proceed to the Summary tab.

  11. When the Summary tab displays, the information entered is validated. Once you see the Validation passed message (at the top of the tab), select OK.

    The Summary tab displays and validates your selected options.

  12. When the Create tab displays, select Create to create the Jenkins virtual machine. When your server is ready, a notification displays in the Azure portal.

    Jenkins is ready notification.