Continuous integration with Jenkins

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set kubernetes-py-jenkins
$ cd pulumi-examples/kubernetes-py-jenkins

This example deploys a container running the Jenkins continuous integration system onto a running Kubernetes cluster using Pulumi and @pulumi/kubernetes.

Note: The code in this repo assumes you are deploying to a cluster that supports the LoadBalancer service type. This includes most cloud providers as well as Docker for Mac Edge w/ Kubernetes. If not (for example if you are targeting minikube or your own custom Kubernetes cluster), replace type: "LoadBalancer" with type: "ClusterIP" in jenkins.py. See the Kubernetes Services docs for more details.

Prerequisites#

1. Install Pulumi
2. Configure Kubernetes
3. Install Python

Deploying the example#

1. Create a new stack:

   pulumi stack init dev

2. Set the root username and password for the Jenkins instance you are about to create:

   pulumi config set username <your desired username>
   pulumi config set password <your desired password> --secret

3. Configure Kubernetes to run without minikube:

   pulumi config set isMinikube false

4. Install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

5. Deploy the stack:

   pulumi up

   Updating (dev):
        Type                                         Name                       Status
    +   pulumi:pulumi:Stack                          kubernetes-py-jenkins-dev  created
    +   └─ jenkins:jenkins:Instance                  dev                        created
    +      ├─ kubernetes:core:PersistentVolumeClaim  dev-pvc                    created
    +      ├─ kubernetes:core:Service                dev-service                created
    +      ├─ kubernetes:core:Secret                 dev-secret                 created
    +      └─ kubernetes:apps:Deployment             dev-deploy                 created
   
   Outputs:
       external_ip: "35.239.72.50"
   
   Resources:
       + 6 created
   
   Duration: 1m57s

6. The deployment is complete! Use pulumi stack output external_ip to see the IP of the service you just deployed:

   pulumi stack output external_ip

   35.239.72.50

   The Jenkins instance is reachable through port 80 of the external IP address. You can now visit http://35.239.72.50/login in a web browser to begin the first-install flow for your new Jenkins instance. Use the username and password that you saved in your Pulumi config to log in.

   Note: If you are deploying to a cluster that does not support type: "LoadBalancer", and deployed the example using type: "ClusterIP" instead, run kubectl port-forward svc/jenkins 8080:80 to forward the cluster port to the local machine and access the service via localhost:8080.

Cleaning up#

Once you’re finished experimenting, you can destroy your stack and remove it to avoid incurring any additional cost:

pulumi destroy
pulumi stack rm