Skip to content

Commit 204122f

Browse files
committed
updating readme for new parameters and config
1 parent b759644 commit 204122f

File tree

1 file changed

+52
-36
lines changed

1 file changed

+52
-36
lines changed

README.md

Lines changed: 52 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -11,28 +11,43 @@ This template creates a development environment for contributing to Kubernetes u
1111

1212
## Features
1313

14-
- Pre-installed development tools:
15-
- Go 1.21.0
16-
- Git
17-
- Docker CLI (latest version)
18-
- Build essentials (gcc, make, etc.)
19-
- vim editor
20-
- kubectl with shell completion
21-
- etcd
22-
23-
- Automatic setup:
24-
- Clones the Kubernetes repository
25-
- Configures Go workspace
26-
- Sets up development environment
27-
- Builds Kubernetes from source
28-
- Configures Docker CLI with custom daemon connection
14+
### Development Tools
15+
- Go 1.21.0
16+
- Git
17+
- Docker CLI
18+
- Build essentials (gcc, make, etc.)
19+
- vim editor
20+
- etcd v3.5.9
21+
- Python 3 with PyYAML
22+
- Network tools (ifconfig, netstat, etc.)
23+
- rsync for file synchronization
24+
25+
### Environment Configuration
26+
- Timezone configuration with tzdata
27+
- Proper user/group setup (UID 1000, root group access)
28+
- Persistent workspace storage
29+
- Configurable Docker daemon connection
30+
- GOPATH configured at /home/coder
31+
- Kubernetes repository cloned directly in home directory
32+
33+
## Template Parameters
34+
35+
- `cpu`: Number of CPU cores (default: 4)
36+
- `memory`: Memory in GB (default: 8)
37+
- `disk_size`: Disk size in GB (default: 50)
38+
- `namespace`: Kubernetes namespace for the workspace (default: coder-workspaces)
39+
- `docker_host`: Docker daemon address to connect to (default: "unix:///var/run/docker.sock")
40+
- `container_image`: Container image to use (default: "ghcr.io/<owner>/kubernetes-coder-dev:latest")
41+
- `kubernetes_repo`: Git repository URL for Kubernetes (default: "https://github.com/kubernetes/kubernetes.git")
42+
- `kubernetes_branch`: Git branch to clone (default: "master")
2943

3044
## Usage
3145

3246
1. Create a new workspace using this template
33-
2. Wait for the initialization script to complete (this may take several minutes)
34-
3. Connect to your workspace
35-
4. The Kubernetes source code will be available at `$HOME/go/src/k8s.io/kubernetes`
47+
2. Configure the parameters as needed
48+
3. Wait for the initialization script to complete
49+
4. Connect to your workspace
50+
5. The Kubernetes source code will be available at `$HOME/kubernetes`
3651

3752
## Development Workflow
3853

@@ -41,39 +56,40 @@ This template creates a development environment for contributing to Kubernetes u
4156
3. Run tests using `make test`
4257
4. Submit your changes following the [Kubernetes contribution guidelines](https://github.com/kubernetes/community/blob/master/contributors/guide/README.md)
4358

44-
## Template Parameters
45-
46-
- `cpu`: Number of CPU cores (default: 4)
47-
- `memory`: Memory in GB (default: 8)
48-
- `disk_size`: Disk size in GB (default: 50)
49-
- `namespace`: Kubernetes namespace for the workspace (default: coder-workspaces)
50-
- `use_kubeconfig`: Whether to use local kubeconfig for authentication (default: false)
51-
- `docker_host`: Docker daemon address to connect to (default: "unix:///var/run/docker.sock")
52-
5359
## Docker Configuration
5460

5561
The template supports connecting to a Docker daemon in different ways:
56-
5762
1. Local socket (default): `unix:///var/run/docker.sock`
5863
2. TCP connection: `tcp://host:port` (e.g., `tcp://localhost:2375`)
5964
3. Remote Docker host: Set the `docker_host` parameter to point to your Docker daemon
6065

61-
Make sure the Docker daemon is accessible from the workspace and proper permissions are set up.
66+
## Container Image
67+
68+
The development container includes:
69+
- Ubuntu 22.04 base image
70+
- All necessary development tools pre-installed
71+
- Proper timezone configuration
72+
- Network utilities
73+
- Python with YAML support
74+
- Development user setup with sudo access
75+
76+
The container image is automatically built and published to GitHub Container Registry with version tags.
6277

6378
## Customization
6479

6580
You can customize this template by:
66-
1. Modifying the `startup_script` in `main.tf`
67-
2. Adjusting resource allocations through template parameters
68-
3. Adding additional tools or configurations as needed
69-
4. Configuring Docker daemon connection settings
81+
1. Modifying the parameters when creating a workspace
82+
2. Using your own fork of Kubernetes
83+
3. Switching between different branches
84+
4. Using a different container image version
7085

7186
## Troubleshooting
7287

7388
If you encounter any issues:
7489
1. Check the workspace logs for startup script output
7590
2. Ensure your cluster has sufficient resources
7691
3. Verify network connectivity to GitHub and other required services
77-
4. Check that all required ports are accessible
78-
5. Verify Docker daemon connectivity using `docker info`
79-
6. Check Docker socket permissions if using local socket
92+
4. Check Docker daemon connectivity using `docker info`
93+
5. Verify the container image is accessible
94+
6. Check that all required ports are accessible
95+
7. Ensure proper permissions for Docker socket if using local socket

0 commit comments

Comments
 (0)