Using Altoros Jenkins for Pivotal Platform

This topic describes how to use Altoros Jenkins for Pivotal Platform.

Prerequisite

You have installed and configured the Altoros Jenkins for Pivotal Platform tile. For information, see Installing and Configuring Altoros Jenkins for Pivotal Platform.

Use Altoros Jenkins for Pivotal Platform

To use Altoros Jenkins with your Pivotal Platform deployment, do the following:

  1. Navigate to https://jenkinsINDEX.YOUR-SYSTEM-DOMAIN. INDEX of Jenkins master instance can see Altoros Jenkins for Pivotal Platform tile > Status A prompt appears requesting permission for Jenkins, see Altoros Jenkins for Pivotal Platform tile > Credentials for these credentials.

  2. Log in to Jenkins using the Administrator credentials.

Note: In case you faced with a blank page after sign in to Jenkins, you need to restart that using https://jenkinsINDEX.YOUR-SYSTEM-DOMAIN/safeRestart.

Note: In Jenkins you have the ability to setup users and their relevant permissions on the Jenkins instance. By default you will not want everyone to be able to define jobs or other administrative tasks in Jenkins. So Jenkins has the ability to have a security configuration in place.

Set up Docker Followers for Jenkins

To use Jenkins Docker Plugin with your Altoros Jenkins for Pivotal Platform deployment, do the following:

  1. Docker appears in the Cloud section of the Jenkins configuration(Manage Jankins-> Configure System), select Docker from the Add a new cloud drop down menu. Docker cloud conf

  2. Select the Docker Cloud details and complete these fields:

    • Name: You can give any name for your cloud.
    • Docker Host URI: This is the connection URL to your Jenkins Docker Cloud host with configured Docker daemon (e.g. tcp://10.111.111.26:4243).
    • Enabled: You need to enable this block. Docker cloud conf2 new
  3. Select the Docker Agent templates and complete these fields:

    • Labels: Labels to give these nodes, for limiting your builds.
    • Enabled: You need to enable this block.
    • Docker Image: Container to be used as a Jenkins follower build node. See jenkins/jnlp-slave as an example.
    • Remote File System Root: Root directory within your image for the Jenkins user to use. You need to set up path /home/jenkins. Docker cloud conf3
  4. Configure a job to use Jenkins Docker Cloud using the labels from the previous step. Job conf