Before getting started, you’ll need to have:
- An Azure tenant and subscription.
- OpenSSH (installation for Windows 10)
Installing Jenkins via Azure Marketplace
The easiest way to install Jenkins is to use the Azure Marketplace link. A couple suggestions when setting up:
- I recommend using an SSH Public Key to sign in. If you haven’t yet, generate one using
ssh-keygenand then get it using
- Set up a domain name label, especially if you aren’t planning to put this behind a different domain.
- Set the VM as B1ms starting off – you can upgrade later as the system is used more.
After creation, modify the NSG created and use your public IP to secure SSH access (check your public IP).
Next, SSH into the server using the IP and check to see if you can update the OS (as of this writing, the image ships with Ubuntu 16.04 LTS, and can be upgraded to 18.04 LTS).
Connecting a Domain
If you’re planning to use a different domain to host Jenkins (as opposed to the provided domain-name-label.location.cloudapp.azure.com), set the following DNS record:
- Host: desired subdomain (ex. jenkins -> jenkins.dfar.io)
- Value: DNS record from Azure.
Since DNS will take a second, check to verify you can access the new server.
Setting up SSL using Let’s Encrypt
The next step is setting up SSL using Let’s Encrypt to allow for an HTTPS connection. First, open the 443 port on the VM:
Now SSH into the server and modify SSL Offloading:
Use the following configuration:
Then run the following commands:
Accessing and Logging Into Jenkins
After completed, access the Jenkins instance at your domain. Verify that both the SSL connection is valid and that you are on the ‘Unlock Jenkins’ page:
Run the following command in the SSHed server to get a code for the screen:
Next, you’ll get a request to either install suggested plugins or select plugins as desired. I recommend going through and selecting the plugins desired to keep the installation minimal. Remove anything from the list that you may not need (such as Subversion). You can always add plugins later if you find you need.
After that, create an admin user for yourself, and you’ll be ready to get started!
After you’ve finished setting up Jenkins, a few next steps would be:
- Setting up a CI/CD job
- Setting up Azure AD Authentication