The Container Images self-service feature can be used to build OCI compliant images based on application source code and store the image in the Team's private container registry in Harbor.

Prerequisites

The Harbor app must be activated to use container images. If it is not activated, contact a platform administrator user so that they can install it.

View container images

To view a list of container images belonging to your team, click on Container images in the main menu of the App Platform Console while in the Team view. The resulting table lists each container image alongside the following details:

Column	Description
Name	The auto-generated name used to identify the Container Image in App Platform
Type	Type of the build task. `docker` or `buildpacks`
Tekton	Link to the `PipelineRun` in the Tekton dashboard
Repository	The repository name of the image in the container registry
Tag	The tag of the image in the container registry
Status	The status of the container image

Create a new container image

Click CREATE CONTAINER IMAGE
Select the build task to use:
- Use Docker to build an image using the ./Dockerfile in your code repository.
- Use Buildpacks to build an image from application source using Buildpacks.
Configure the Code Repository

Select the Repository from the list. Only registered Code Repositories are shown here.
Select the reference (a branch or tag).
(optional) Change the path. When using the Docker build task, the default path is Dockerfile. To use a Dockerfile in a specific folder, use foldername/Dockerfile.

Optionally: Adjust the image name and tag.
Optionally: Add Extra Arguments to pass on to the build executor.
Optionally: Create a webhook listener to trigger the build based on a repository webhook event.

📘
The Create webhook listener option is only available when the Git service of the selected repository is Gitea. When the create webhook listener option is selected both the event listener and the webhook (in Gitea) will be automatically configured.

Check the status of a container image

There are two options to check the status of the container image

Using the App Platform Console: Click on the PipelineRun link in the list of container images.
Using the Tekton CLI: Start a shell in the console and run the following command:
```
tkn pipelineruns list
tkn pipelinerun logs <pipelinerun-name> -f
```

Restart a build task

To restart a build task:

Start a shell in the console.

Run the following command:

tkn pipelines list
tkn pipeline start <pipeline-name> --use-pipelinerun <pipelinerun-name>