docs: Add comprehensive buildkit drivers documentation with Kubernetes focus by Copilot · Pull Request #695 · project-dalec/dalec

Copilot · 2025-07-18T04:54:58Z

Adds comprehensive documentation for Docker buildkit drivers, with specific focus on the Kubernetes driver for users who want to build Dalec packages inside Kubernetes environments.

Changes Made

New Documentation

Added: /website/docs/buildkit-drivers.md - Complete guide covering buildkit drivers
Updated: Sidebar navigation to include the new documentation under "Getting Started"

Content Coverage

Buildkit Drivers Overview:

Explanation of different driver types (docker, docker-container, kubernetes, remote)
When and why to use each driver type
Default Docker driver usage with Dalec examples

Kubernetes Driver (Primary Focus):

Step-by-step setup instructions
Prerequisites and RBAC requirements
Advanced configuration with resource limits
Production-ready examples with custom namespaces and service accounts
Integration with Kubernetes secrets and networking

Practical Examples:

# Create Kubernetes builder
docker buildx create \
  --driver kubernetes \
  --driver-opt namespace=dalec-builds \
  --driver-opt requests.cpu=500m \
  --driver-opt requests.memory=1Gi \
  --name dalec-k8s-builder

# Use with Dalec
docker buildx build \
  -f my-dalec-spec.yml \
  --target=ubuntu/jammy \
  -t my-package:latest \
  .

Additional Features:

Complete YAML examples for Kubernetes RBAC setup
Troubleshooting section with debugging commands
Resource management and security best practices
References to official Docker documentation

Validation

✅ Documentation builds successfully without errors
✅ All external links verified (Docker buildkit docs)
✅ Content follows existing documentation patterns
✅ Navigation properly integrated into sidebar

This provides users with the guidance they need to leverage Dalec's capabilities in Kubernetes environments, addressing scalability, security, and resource management concerns.

Fixes #694.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

…etes driver Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

sozercan · 2025-07-18T05:32:06Z

+
+Buildkit drivers are different backends that execute the build operations. Each driver has different capabilities and is suitable for different use cases:
+
+- **docker**: The default driver that runs builds in the Docker daemon


add links to each of these drivers

Added links to all four buildkit drivers (docker, docker-container, kubernetes, remote) pointing to their respective Docker documentation pages. eb7528b

Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

sozercan · 2025-07-18T21:15:32Z

undo changes here and yarn.lock

Reverted package-lock.json and yarn.lock changes. 70b9c7e

Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

cpuguy83 · 2026-06-01T20:27:08Z

@copilot rebase

Copilot · 2026-06-01T20:30:46Z

@copilot rebase

Merged the latest main branch changes into this branch, resolving the sidebars.ts conflict (preserving both buildkit-drivers and system-extensions entries).

cpuguy83 · 2026-06-01T20:36:35Z

@copilot All commits must include a DCO sign-off

Copilot · 2026-06-01T20:40:43Z

@copilot All commits must include a DCO sign-off

Adding DCO sign-off (Signed-off-by:) to existing commits requires rewriting git history and force-pushing, which isn't supported by the tooling available to me. A maintainer would need to do one of the following:

Run git rebase -i origin/main (marking commits to reword or using --signoff flag), then force-push: git rebase --signoff origin/main && git push --force-with-lease
Use GitHub's "Squash and merge" option and add the sign-off to the squash commit message manually

Signed-off-by: Mateusz Gozdek <mgozdek@microsoft.com>

invidian · 2026-06-02T08:30:38Z

Fixed DCO issue.

Copilot

Pull request overview

This PR adds a new Docusaurus documentation page describing Docker BuildKit driver options with a focus on using the kubernetes Buildx driver for running Dalec builds inside Kubernetes, and wires the page into the “Getting Started” sidebar.

Changes:

Added a new buildkit-drivers doc page under website/docs/.
Updated the docs sidebar to link the new page from the “Getting Started” section.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
`website/sidebars.ts`	Adds the new `buildkit-drivers` doc to the “Getting Started” sidebar items.
`website/docs/buildkit-drivers.md`	Introduces a new page explaining BuildKit drivers and a basic Kubernetes-driver example workflow.

+title: Buildkit Drivers
+---
+
+Dalec builds use Docker Buildkit under the hood. Buildkit supports different drivers that determine where and how builds are executed. Understanding these drivers can help you choose the right setup for your build environment, especially when building at scale or in containerized environments like Kubernetes.


invidian · 2026-06-03T05:02:29Z

+
+### Setting up the Kubernetes Driver
+
+2. **Create a builder instance**:


@copilot please fix this and numbering below.

Fixed in a4689f8 — renumbered the Kubernetes setup steps so the sequence starts at 1 and continues correctly below.

+     --use
+   ```
+
+3. **Build with Dalec using the Kubernetes driver**:


cpuguy83 · 2026-06-02T22:14:32Z

+   docker buildx build \
+     -t my-package:latest \
+     -f my-spec.yml \
+     --target=azl3 \


@copilot please fix.

Fixed in 22760d8 — updated the example target from azl3 to azlinux3 in website/docs/buildkit-drivers.md.

cpuguy83 · 2026-06-02T22:14:36Z

Ugh, needs a rebase apparently.

invidian

LGTM except the steps numbering.

Initial plan

07e5429

Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

Copilot AI assigned Copilot and sozercan Jul 18, 2025

Copilot started work on behalf of sozercan July 18, 2025 04:55 View session

Add comprehensive buildkit drivers documentation with focus on Kubern…

ac05535

…etes driver Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] docs: document buildkit drivers specifically kubernetes driver~~ docs: Add comprehensive buildkit drivers documentation with Kubernetes focus Jul 18, 2025

Copilot AI requested a review from sozercan July 18, 2025 05:09

Copilot finished work on behalf of sozercan July 18, 2025 05:09

Update buildkit-drivers.md

f8b97e9

Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

sozercan reviewed Jul 18, 2025

View reviewed changes

Copilot started work on behalf of sozercan July 18, 2025 05:32 View session

Add links to buildkit drivers in documentation

98d7628

Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

Copilot AI requested a review from sozercan July 18, 2025 05:39

Copilot finished work on behalf of sozercan July 18, 2025 05:39

sozercan reviewed Jul 18, 2025

View reviewed changes

Copilot started work on behalf of sozercan July 18, 2025 21:15 View session

Revert package-lock.json and yarn.lock changes

588ca78

Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com> Signed-off-by: Sertaç Özercan <852750+sozercan@users.noreply.github.com>

Copilot AI requested a review from sozercan July 18, 2025 21:19

Copilot finished work on behalf of sozercan July 18, 2025 21:19

cpuguy83 approved these changes Jun 1, 2026

View reviewed changes

Copilot started work on behalf of cpuguy83 June 1, 2026 20:27 View session

Copilot finished work on behalf of cpuguy83 June 1, 2026 20:31

Copilot AI requested a review from cpuguy83 June 1, 2026 20:31

Copilot started work on behalf of cpuguy83 June 1, 2026 20:36 View session

Copilot finished work on behalf of cpuguy83 June 1, 2026 20:39

Copilot started work on behalf of cpuguy83 June 1, 2026 20:39 View session

Copilot finished work on behalf of cpuguy83 June 1, 2026 20:40

invidian force-pushed the copilot/fix-694 branch from 58dad5c to b838429 Compare June 2, 2026 07:31

invidian temporarily deployed to deploy-docs June 2, 2026 07:31 — with GitHub Actions Inactive

invidian force-pushed the copilot/fix-694 branch from b838429 to 8f64562 Compare June 2, 2026 08:25

invidian temporarily deployed to deploy-docs June 2, 2026 08:25 — with GitHub Actions Inactive

Merge branch 'main' into copilot/fix-694

cdaf848

Signed-off-by: Mateusz Gozdek <mgozdek@microsoft.com>

invidian force-pushed the copilot/fix-694 branch from 8f64562 to cdaf848 Compare June 2, 2026 08:30

invidian temporarily deployed to deploy-docs June 2, 2026 08:30 — with GitHub Actions Inactive

cpuguy83 marked this pull request as ready for review June 2, 2026 22:12

Copilot AI review requested due to automatic review settings June 2, 2026 22:12

Copilot started reviewing on behalf of cpuguy83 June 2, 2026 22:12 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

Copilot started work on behalf of cpuguy83 June 2, 2026 22:14 View session

docs: fix invalid azlinux3 build target example

22760d8

Copilot finished work on behalf of cpuguy83 June 2, 2026 22:18

Copilot AI temporarily deployed to deploy-docs June 3, 2026 05:01 Inactive

Copilot started work on behalf of invidian June 3, 2026 05:02 View session

invidian requested changes Jun 3, 2026

View reviewed changes

docs: fix buildkit driver setup step numbering

a4689f8

Copilot finished work on behalf of invidian June 3, 2026 05:07

Copilot AI requested a review from invidian June 3, 2026 05:07

invidian approved these changes Jun 3, 2026

View reviewed changes

Copilot AI temporarily deployed to deploy-docs June 4, 2026 20:45 Inactive


		Buildkit drivers are different backends that execute the build operations. Each driver has different capabilities and is suitable for different use cases:

		- docker: The default driver that runs builds in the Docker daemon


		### Setting up the Kubernetes Driver

		2. Create a builder instance:

Conversation

Copilot AI commented Jul 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes Made

New Documentation

Content Coverage

Validation

Uh oh!

sozercan Jul 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 18, 2025

Choose a reason for hiding this comment

Uh oh!

sozercan Jul 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jul 18, 2025

Choose a reason for hiding this comment

Uh oh!

cpuguy83 commented Jun 1, 2026

Uh oh!

Copilot AI commented Jun 1, 2026

Uh oh!

cpuguy83 commented Jun 1, 2026

Uh oh!

Copilot AI commented Jun 1, 2026

Uh oh!

invidian commented Jun 2, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

invidian Jun 3, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 3, 2026

Choose a reason for hiding this comment

Uh oh!

cpuguy83 Jun 2, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 2, 2026

Choose a reason for hiding this comment

Uh oh!

cpuguy83 commented Jun 2, 2026

Uh oh!

invidian left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Copilot AI commented Jul 18, 2025 •

edited

Loading