Jenkins infra on Azure

Table of Contents

• Requirements
• HowTo
  • Provision

This repository hosts the infrastructure-as-code definition for all the Azure hosted resources for the Jenkins Infrastructure Project.

See also https://github.com/jenkins-infra/azure-net for all global network related resources.

Requirements

In order to use this repository to provision the Jenkins infrastructure on azure, you need:

• An Azure account

• The requirements (of the shared tools) listed at shared-tools/terraform#requirements

• The Terraform AzureRM Backend Configuration on a local file named backend-config:

  • The content can be retrieved from the outputs of the (private) repository terraform-states

  • This file (backend-config) is git-ignored

• The git command line to allow cloning the repository and its submodule shared-tools

  • This repository has submodules. Once you cloned the repository, execute the following command to obtain the shared tools:

git submodule update --init --recursive

• Routing to database (private endpoints and private DNSes):

  • VPN access is required with routing to the database subnets set up to your user

  • As there are no public DNS, set up your local /etc/hosts (check the providers.tf for details)

HowTo

Provision

❗	Don’t blindly execute the terraform code located in this repository on your own account as it may lead your account bill to significantly increase.

Once you’ve fulfilled the Requirements, you may execute any command from https://github.com/jenkins-infra/shared-tools/blob/main/terraform/README.adoc#available-commands by adding the correct flag --directory pointing to .shared-tools/terraform/:

make --directory=.shared-tools/terraform help
make --directory=.shared-tools/terraform lint
# ...

A usual change to this repository looks like the following:

• Fork the repository and clone it locally

• Follow the Requirements steps to obtain the shared tools

• Start by running a full make --directory=.shared-tools/terraform validate command to ensure that you work on a sane base (should generate a report TXT file with no changes to be applied)

• Edit the Terraform project files

• Run the command make --directory=.shared-tools/terraform validate again to ensure that your changes are OK

• Commit, push and open a pull request to let the Jenkins pipeline run the test + plan (as per https://github.com/jenkins-infra/shared-tools/blob/main/terraform/README.adoc#jenkins-pipeline)