Building images

This guide shows you how to build a container image from source code stored in a repository using Webscale CodeDirect. The resulting image will be pushed to your configured image registry. You will also learn how to manually trigger a build and view its logs.

Prerequisites

Before you begin, ensure you have:

• A source repository that contains a Dockerfile

• An image registry configured under Providers

1. Create a new Builder

1. Go to: control.webscale.com/builders

2. Click the blue plus (+) button to create a new Builder.

You will see configuration sections for:

• Build context
• Image destination
• Build configuration
• Build triggers

We will focus on the required fields in this guide.

2. Configure the build context

1. Expand the Build context panel and click Connect a repository or select an already connected repository.
2. Follow the prompts to authorize a connection to your repository.
3. After completing the connection, return to the Builder and select your repository from the dropdown.

3. Specify the image destination

1. Expand the Image destination panel and choose your configured Image registry.
2. Select the Image repository where the built image will be pushed.

4. Set the build configuration

1. Expand the Build configuration panel and provide the relative path to the Dockerfile in your source repository.

5. Optionally specify build triggers

If you would like a build to be triggered whenever code is pushed to the repository, select “Build on commit” and specify which branches you would like to trigger a build.

Otherwise, leave this section blank.

6. Save the Builder

Click Submit to save the Builder.

You now have a Builder capable of producing container images.

7. Manually trigger a build

1. In the Builders list, locate your newly created Builder.
2. Click the play (▶) button next to it.
3. Leave the source reference at HEAD and click Submit.

This action creates a new build task.

8. Monitor the build progress

1. Watch for the spinning arrows icon in the top-right corner of the Control Panel. This indicates that a task is running.
2. Click the icon, then click Zoom to view the build logs.

Look for key log entries such as:

• “Cloning git repository…” — confirms the source repo is being pulled.
• “Checking out specific commit: ” — shows which commit was used.
• “Pushing image to …” — indicates the registry, repository, and tag for the final image(s).

✅ indicates the build was successful. ❌ indicates the build failed.

Result

You have successfully:

• Created a CodeDirect Builder
• Connected it to a source repository
• Configured your output image registry
• Triggered a manual build
• Viewed the build logs

Last modified on June 3, 2026