Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jul 18, 2025

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.

…etes driver

Co-authored-by: sozercan <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

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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add links to each of these drivers

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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>
Copilot AI requested a review from sozercan July 18, 2025 05:39
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

undo changes here and yarn.lock

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Co-authored-by: sozercan <852750+sozercan@users.noreply.github.com>
Copilot AI requested a review from sozercan July 18, 2025 21:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: document buildkit drivers specifically kubernetes driver

2 participants