1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
# Container Registry Infrastructure
Local container registry for Yocto/OE builds - analogous to package-index for containers.
## Quick Start
```bash
# 1. Configure in local.conf
CONTAINER_REGISTRY_URL = "localhost:5000"
CONTAINER_REGISTRY_NAMESPACE = "yocto"
CONTAINER_REGISTRY_INSECURE = "1"
# 2. Generate the helper script
bitbake container-registry-index -c generate_registry_script
# 3. Start registry, push images
$TOPDIR/container-registry/container-registry.sh start
$TOPDIR/container-registry/container-registry.sh push
# 4. Import 3rd party images
$TOPDIR/container-registry/container-registry.sh import docker.io/library/alpine:latest
# 5. Use with vdkr (10.0.2.2 is QEMU slirp gateway to localhost)
vdkr vconfig registry 10.0.2.2:5000/yocto
vdkr pull container-base
```
## Helper Script Commands
Script location: `${TOPDIR}/container-registry/container-registry.sh` (outside tmp/, persists)
| Command | Description |
|---------|-------------|
| `start` | Start the container registry server |
| `stop` | Stop the container registry server |
| `status` | Check if registry is running |
| `push` | Push all OCI images from deploy/ to registry |
| `import <image> [name]` | Import 3rd party image to registry |
| `list` | List all images with their tags |
| `tags <image>` | List tags for a specific image |
| `catalog` | Raw API catalog output |
## Configuration (local.conf)
```bitbake
# Registry endpoint (host-side)
CONTAINER_REGISTRY_URL = "localhost:5000"
# Image namespace
CONTAINER_REGISTRY_NAMESPACE = "yocto"
# Mark as insecure (HTTP)
CONTAINER_REGISTRY_INSECURE = "1"
# For Docker targets
DOCKER_REGISTRY_INSECURE = "localhost:5000"
# Persistent storage (default: ${TOPDIR}/container-registry)
CONTAINER_REGISTRY_STORAGE = "/data/container-registry"
```
## vdkr Registry Usage
### Pull Behavior with Registry Fallback
When a registry is configured, vdkr uses **registry-first, Docker Hub fallback** for pulls:
1. Try configured registry first (e.g., `10.0.2.2:5000/yocto/alpine`)
2. If not found, fall back to Docker Hub (`docker.io/library/alpine`)
This allows you to override images with local builds while still pulling public images normally.
```bash
# One-off
vdkr --registry 10.0.2.2:5000/yocto pull alpine
# Persistent config
vdkr vconfig registry 10.0.2.2:5000/yocto
vdkr pull alpine # Tries registry first, falls back to Docker Hub
vdkr pull container-base # Pulls from registry (your Yocto-built image)
vdkr run alpine echo hello
# Clear config
vdkr vconfig registry --reset
# Image management (all commands use registry prefix for stored images)
vdkr image ls
vdkr image inspect alpine # Works for both registry and Docker Hub images
vdkr image rm <image>
vdkr image rm e7b39c54cdec # Image IDs work without transformation
```
### Registry Transform
When a registry is configured:
- `pull`, `run` - Use fallback (registry first, then Docker Hub)
- `inspect`, `history`, `rmi`, `tag`, `images` - No transform (use actual local image names)
- Image IDs (hex strings like `e7b39c54cdec`) - Never transformed
## Baking Registry Config into Target Images
Use `IMAGE_FEATURES` to auto-select the right package based on `CONTAINER_PROFILE`:
```bitbake
# In local.conf
CONTAINER_REGISTRY_URL = "localhost:5000"
CONTAINER_REGISTRY_INSECURE = "1"
DOCKER_REGISTRY_INSECURE = "localhost:5000"
# Enable the feature
IMAGE_FEATURES:append = " container-registry"
```
This installs:
- **Docker profile** → `docker-registry-config` → `/etc/docker/daemon.json`
- **Podman profile** → `container-oci-registry-config` → `/etc/containers/registries.conf.d/`
## Files
| File | Description |
|------|-------------|
| `container-registry-index.bb` | Generates helper script with baked-in paths |
| `container-registry-populate.bb` | Alternative bitbake-driven push |
| `container-oci-registry-config.bb` | OCI tools config (Podman/Skopeo/Buildah/CRI-O) |
| `docker-registry-config.bb` | Docker daemon config |
| `files/container-registry-dev.yml` | Development registry config |
## Storage
Registry data and script are stored at `${TOPDIR}/container-registry/` by default:
- Outside tmp/, persists across builds and cleanall
- Imported and pushed images are copied here
- Script regenerates with same paths after tmp/ cleanup
## Localhost to 10.0.2.2 Translation
For vdkr baked configs, `localhost` URLs are auto-translated to `10.0.2.2` (QEMU slirp gateway):
- Set `CONTAINER_REGISTRY_URL = "localhost:5000"` in local.conf
- Host-side operations use localhost directly
- vdkr inside QEMU accesses via 10.0.2.2 automatically
|
