Installing CloudBees Jenkins X Distribution on your EKS cluster

Once you have created your EKS cluster, you are now ready to install CloudBees Jenkins X Distribution to your cluster.

  1. From your command line, change to the directory containing the pre-configured jx-requirements-eks.yml requirements file that was unarchived with your jx program binary. For example, macOS defaults to the Downloads directory:

    cd /Users/acmeuser/Downloads/
  2. Run Jenkins X Boot at the command-line jx and include the pre-configured jx-requirements-eks.yml file:

    jx boot -r jx-requirements-eks.yml

The interactive command-line tool guides you through the process of configuring and installing the resources needed to complete your GitOps development environment:

  1. The program uses the region that you have configured to authenticate against AWS. Either from the AWS_REGION env variable or from the /Users/acmeuser/.aws/config files.

  2. The program prompts you for the Cluster Name, which you previously chose (in this example, acmecluster1).

  3. The program prompts you for a Git Owner or your GitHub account (in this example, acmecorp).

  4. The program prompts you to enter Storage Bucket URLs for saving various storage resources:

    1. Logs: You can use an existing storage bucket URL, or press Enter and a bucket will be created for you.

    2. Reports: You can use an existing storage bucket URL, or press Enter and a bucket will be created for you.

    3. Repository: You can use an existing storage bucket URL, or press Enter and a bucket will be created for you.

  5. If you are prompted to upgrade your Jenkins X binaries or Platform at this stage of installation, press N to refuse the upgrade.

  6. The program prompts you to enter a Jenkins X administrator Username. You can use your current GitHub account for consistency (in this example, acmecorp).

    1. The program prompts you to enter a password for the Jenkins X administrator.

  7. The program prompts you for a Pipeline Bot Git username (for example acmebot). This creates a bot for automating your GitOps process by promoting code from your development environment to your staging and/or production environments.

    1. Create a new GitHub account strictly for the build control bot

    2. Invite the bot account to your organization

    3. Create a Git token for the Pipeline Bot with the correct permissions via this GitHub Link and copy the 40 character token

      The 40-character token generated by GitHub is only shown once so you must copy this immediately before you close the browser tab or window, as the token cannot be retrieved once it is displayed.
    4. Paste the copied GitHub token created for the Pipeline Bot when prompted

  8. The program prompts you to provide a hash-based message authentication code (HMAC) token for authenticating incoming webhooks from your Git provider and accept PR data and other payloads to your cluster. Press Enter to create a token or copy and paste one into the command line if you have an existing token.

  9. The program prompts you to configure an external Docker Registry. Press Enter for No, and your docker images will be privately stored on the AWS Elastic Container Registry by default.