Amazon

NOTE

• Ensure you are logged into GitHub else you will get a 404 error when clicking the links below
• The quickstart guides are for users who want to get up and running quickly with Jenkins X. Refer to the eks-jx terraform module readme for all the variables that can be customized.
  • Refer to this page for setting up Jenkins X v3 with external/existing vault.
  • For installing Jenkins X in an existing EKS cluster, refer to this section.
  • To use AWS secrets manager instead of vault, refer to this section
• Always use the latest module version for the eks-jx module. The list of versions can be found here.
• Do not specify the last digit of the kubernetes version, so if you want to provision an EKS cluster with kubernetes 1.21.5, just specify 1.21. See this issue for more details.

EKS + Terraform + Vault/ASM + Github

This is our current recommended quickstart for EKS:

Note: remember to create the Git repositories below in your Git Organization rather than your personal Git account else this will lead to issues with ChatOps and automated registering of webhooks.

• Create Git Repository for Infrastructure based on the jx3-gitops-repositories/jx3-terraform-eks

  • if the above button does not work then please Login to GitHub first and then retry the button

• Choose the cluster git repository based on the secrets backend

  • Create Git Repository for Jenkins X Cluster based on the jx3-gitops-repositories/jx3-eks-vault

  • Create Git Repository for Jenkins X Cluster based on the jx3-gitops-repositories/jx3-eks-asm

• Install terraform CLI

• Install jx CLI

• For AWS SSO ensure you have installed AWSCLI version 2 - see here. You must then configure it to use Named Profiles - see here

• You should use a dedicated git user account for the Bot user. Jenkins X will use this user to interact with git. After you are logged in with the Bot user account you may use the following link Create Git Token for the Bot user

• Override the variable defaults in the Infrastructure repository. (E.g, edit variables.tf, set TFVAR environment variables, or pass the values on the terraform command line.)

  • cluster_version: Kubernetes version for the EKS cluster. (should be 1.20 at the moment)
  • region: AWS region code for the AWS region to create the cluster in.
  • jx_git_url: URL of the Cluster repository.
  • jx_bot_username: The username of the git bot user

• commit and push any changes to your Infrastructure git repository:

      git commit -a -m "fix: configure cluster repository and project"
      git push

• Define an environment variable to pass the bot token into Terraform:

      export TF_VAR_jx_bot_token=my-bot-token

• Now, initialise, plan and apply Terraform:

      terraform init
      terraform plan
      terraform apply

• Tail the Jenkins X installation logs

  $(terraform output follow_install_logs)

• Once finished you can now move into the Jenkins X Developer namespace

  jx ns jx

• and create or import your applications

• Create or import projects

For more details on how to install Jenkins X on AWS EKS see Github repository for Jenkins X Terraform module for EKS

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.