Build a container image from source control using Code Engine

Overview
This guide will show you how to use the experimental IBM Code Engine to build a container image from a Source control repository. Behind the scenes Code Engine will use Tekton pipelines to pull our source code from a Github repository and then create a container image using the supplied Docker file. After the build is complete Code Engine will push the new container image in to the IBM Cloud Container Registry.
NOTE: Code Engine is currently an experimental offering and all resources are deleted every 7 days.
Start a session in IBM Cloud Shell
In the IBM Cloud console, click the IBM Cloud Shell icon
​
.
A session starts and automatically logs you in through the IBM Cloud CLI.
Target Resource Group
In oder to interact with the Code Engine CLI we first need to target the Resource Group where the Code Engine project will be created:
1
$ ibmcloud target -g <Your Resource Group>
Copied!
Create a Code Engine Project
The first step is to create a Code Engine project.
Keep in mind during the Beta phase you are limited to one Code Engine project per region. If you already have a Code Engine project you can simply target that project using the command ibmcloud ce project target -n <name of project>
We'll specify the --target option to automatically have the Code Engine cli target our new project:
1
$ ibmcloud ce project create -n <Project Name> --target
Copied!
The project creation can take a few minutes, but when it completes you should see something like this:
1
$ ibmcloud ce project create -n ce-demo-project --target
2
Creating project 'ce-demo-project'...
3
Waiting for project 'ce-demo-project' to be in ready state...
4
Now selecting project 'ce-demo-project'.
5
OK
Copied!
Create an API Key for Code Engine for Registry Access
As part of our Build process we are going be pulling a public Github repo but then pushing the built container in to IBM Cloud Container Registry. In order for our Code Engine project to be able to push to the registry we'll need to create an API key.
1
$ ibmcloud iam api-key-create <Project Name>-cliapikey -d "API Key for talking to Image registry from Code Engine" --file key_file
Copied!
Create Code Engine Registry Secret
With our API key created, we will now add the IBM Cloud Container Registry to Code Engine. When using the IBM Container Registry the username will always be iamapikey. If you would like to push to an alternate IBM Container Registry endpoint update the --server flag accordingly.
1
$ export CR_API_KEY=`jq -r '.apikey' < key_file`
2
​
3
$ ibmcloud ce registry create --name ibmcr --server us.icr.io --username iamapikey --password "${CR_API_KEY}"
Copied!
You can view all of your registry secrets by running the command: ibmcloud ce registry list.
1
$ ibmcloud ce registry list 
2
Project 'demo-rt' and all its contents will be automatically deleted 7 days from now.
3
Listing image registry access secrets...
4
OK
5
​
6
Name   Age  
7
ibmcr  11s
Copied!
Create Code Engine Build Definition
With the Registry access added we can now create our Build definition. If you do not already have a Container namespace to push images to, please follow [this guide to create one.
1
$ ibmcloud ce build create --name go-app-example-build --source https://github.com/greyhoundforty/ce-build-example-go --strategy kaniko --size medium --image us.icr.io/<namespace>/go-app-example --registry-secret ibmcr
Copied!
The breakdown of the command:
name: The name of the build definition 
source: The Source control repository where our code lives
strategy:  The build strategy  we will use to build the image. In this case since our repository has a Dockerfile we will use kaniko
size: The size of the build defines how CPU cores, memory, and disk space are assigned to the build
image: The Container Registry namespace and image name to push our built container image
registry-secret: The Container Registry secret that allows Code Engine to push and pull images
Submit the Build Job
Before the Build run is submitted (the actual process of building the container image), we’ll want to target the underlying Kubernetes cluster that powers Code Engine. This will allow us to see the pods that are spun up for the build as well as track it’s progress. To have kubctl within Cloud Shell target our cluster run the following command: ibmcloud ce project target -n <Name of Project> -k
You should see output similar to this:
1
$ ibmcloud ce project target -n demo-rt -k 
2
Selecting project 'demo-rt'...
3
Added context for 'demo-rt' to the current kubeconfig file.
4
OK
Copied!
With kubectl properly configured we can now launch the actual build of our container image using the buildrun command. We specify the build definition we created previously with the --build flag:
1
$ ibmcloud ce buildrun submit --name go-app-buildrun-v1 --build go-app-example-build
Copied!
You can check the status of the build run using the command ibmcloud ce buildrun get --name <Name of build run>
1
$ ibmcloud ce buildrun get --name go-app-buildrun-v1
2
Project 'demo-rt' and all its contents will be automatically deleted 7 days from now.
3
Getting build run 'go-app-buildrun-v1'...
4
OK
5
​
6
Name:          go-app-buildrun-v1
7
ID:            d378e865-ecf4-4e26-932d-acb437eef0ef
8
Project Name:  demo-rt
9
Project ID:    ab07a001-9a77-4fd8-82e8-d4f8395ad735
10
Age:           36s
11
Created:       2020-09-23 09:13:33 -0500 CDT
12
Status:
13
  Reason:      Running
14
  Registered:  Unknown
15
​
16
Instances:
17
  Name                                Running  Status   Restarts  Age
18
  go-app-buildrun-v1-xpqfq-pod-hqchd  2/4      Running  0         34s
Copied!
You can also check on the status of the Kubernetes pods by running kubectl get pods
1
$ kubectl get pods
2
NAME                                 READY   STATUS      RESTARTS   AGE
3
go-app-buildrun-v1-xpqfq-pod-hqchd   2/4     Running     0          41s
Copied!
If the build completes successfully the pods will show Completed and the build run will show Succeeded
1
$ kubectl get pods
2
NAME                                 READY   STATUS      RESTARTS   AGE
3
go-app-buildrun-v1-xpqfq-pod-hqchd   0/4     Completed   0          4m10s
4
​
5
$ ibmcloud ce buildrun get --name go-app-buildrun-v1
6
Project 'demo-rt' and all its contents will be automatically deleted 7 days from now.
7
Getting build run 'go-app-buildrun-v1'...
8
OK
9
​
10
Name:          go-app-buildrun-v1
11
ID:            d378e865-ecf4-4e26-932d-acb437eef0ef
12
Project Name:  demo-rt
13
Project ID:    ab07a001-9a77-4fd8-82e8-d4f8395ad735
14
Age:           4m26s
15
Created:       2020-09-23 09:13:33 -0500 CDT
16
Status:
17
  Reason:      Succeeded
18
  Registered:  True
19
​
20
Instances:
21
  Name                                Running  Status     Restarts  Age
22
  go-app-buildrun-v1-xpqfq-pod-hqchd  0/4      Succeeded  0         4m24s
Copied!

IBM Cloud Object Storage - Previous

Cross-account sync with free IKS Cluster

Next - IBM Virtual Private Cloud

Site to Site IPsec with VPC VPNaaS

Last modified 1yr ago

Copy link

Contents

Overview

Start a session in IBM Cloud Shell

Target Resource Group

Create a Code Engine Project

Create an API Key for Code Engine for Registry Access

Create Code Engine Registry Secret

Create Code Engine Build Definition

Submit the Build Job