Package inventory for Go module migration
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
Hướng nghiên cứu
Start with the package inventory in the issue, grouped by consumers, subcommands, the legacy Compose loader, and other packages. Review the listed importers and consumer dependencies, then record a decision beneath each package; done means the inventory reflects which packages should remain public or move to internal. This is broad API design work, and the issue names no source files or tests to start from.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Adopting Go modules changes the import path of every public package.
That makes it a good moment to decide which packages we keep public and which we can break or move to internal/.
Tick an item once we've decided on it, and write the decision under it.
How to read the notes:
- "Consumers" are repos we checked by hand: X buildx, C compose, K buildkit, G go-containerregistry, T testcontainers-go, M model-runner, P mcp-gateway, D
cmd/docker-trust. - "Importers" are other high-profile repos whose current default branch imports the package outside test files.
High profile means at least 1,000 stars and not archived; the star count is in parentheses.
The list is based on pkg.go.dev importer data, checked against each repo's current source.
Imported by the checked consumers
-
cli- Consumers: buildx, compose,
cmd/docker-trust. - Importers: aquasecurity/trivy (39k), keploy/keploy (19k), werf/werf (4.7k), docker/docker-agent (4.4k), ddev/ddev (3.9k), opencurve/curve (2.4k).
- Consumers: buildx, compose,
-
cli/command- Consumers: buildx, compose, testcontainers-go, model-runner, mcp-gateway,
cmd/docker-trust. - Importers: portainer/portainer (39k), aquasecurity/trivy (39k), keploy/keploy (19k), tilt-dev/tilt (10k), alibaba/higress (9.6k), getarcaneapp/arcane (7.9k), k3d-io/k3d (6.6k), psviderski/uncloud (5.5k), werf/werf (4.7k), nicholas-fedor/watchtower (4.6k), docker/docker-agent (4.4k), ddev/ddev (3.9k), supabase/cli (2.4k), opencurve/curve (2.4k), shellhub-io/shellhub (2.1k), zarf-dev/zarf (2.1k), kimdre/doco-cd (1.7k), datastack-net/dockerized (1.3k).
- Its
Cliinterface is the main API we commit to.
- Consumers: buildx, compose, testcontainers-go, model-runner, mcp-gateway,
-
cli/command/container- Consumers: compose only.
- Compose uses
RunExec,NewExecOptions,RunAttach,AttachOptions,RunStats,RunStartandForwardAllSignals. - Importers: none.
- A small public package with just these functions would let this one go internal.
-
cli/command/formatter- Consumers: buildx, compose,
cmd/docker-trust. - Importers: none.
- Consumers: buildx, compose,
-
cli/command/image/build- Consumers: compose only (the classic builder's build-context helpers).
- Importers: loft-sh/devspace (5.2k), digitalocean/doctl (3.5k).
-
cli/command/inspect- Consumers:
cmd/docker-trust. - Importers: none.
- Consumers:
-
cli/config- Consumers: buildx, compose, buildkit, go-containerregistry, mcp-gateway,
cmd/docker-trust. - Importers: nektos/act (72k), wagoodman/dive (55k), jesseduffield/lazydocker (53k), aquasecurity/trivy (39k), 1Panel-dev/1Panel (37k), kubernetes/minikube (32k), dagger/dagger (16k), GoogleContainerTools/skaffold (16k), loft-sh/devpod (15k), earthly/earthly (12k), kubescape/kubescape (12k), loft-sh/vcluster (11k), containerd/nerdctl (10k), tilt-dev/tilt (10k), replicate/cog (9.5k), rancher-sandbox/rancher-desktop (7.4k), azukaar/cosmos-server (6.2k), psviderski/uncloud (5.5k), tsuru/tsuru (5.3k), loft-sh/devspace (5.2k), werf/werf (4.7k), alexellis/arkade (4.6k), nicholas-fedor/watchtower (4.6k), docker/docker-agent (4.4k), whalebrew/whalebrew (4.2k), genuinetools/img (4.0k), okteto/okteto (3.6k), gardener/gardener (3.5k), digitalocean/doctl (3.5k), openfaas/faasd (3.3k), inspektor-gadget/inspektor-gadget (2.9k), supabase/cli (2.4k), aws/eks-anywhere (2.1k), shellhub-io/shellhub (2.1k), apptainer/apptainer (2.0k), project-copacetic/copacetic (1.7k), kimdre/doco-cd (1.7k), genuinetools/reg (1.7k), dragonflyoss/nydus (1.7k), containerd/stargz-snapshotter (1.6k), ktock/buildg (1.5k), solo-io/bumblebee (1.3k), railwayapp/railpack (1.2k), gitlab-org/cli on GitLab (1.1k).
- Covered by the open PR that extracts config into its own module (#6210).
- Consumers: buildx, compose, buildkit, go-containerregistry, mcp-gateway,
-
cli/config/configfile- Consumers: buildx, compose, buildkit, go-containerregistry, mcp-gateway,
cmd/docker-trust. - Importers: istio/istio (38k), hashicorp/nomad (17k), dagger/dagger (16k), GoogleContainerTools/skaffold (16k), loft-sh/devpod (15k), earthly/earthly (12k), loft-sh/vcluster (11k), containerd/nerdctl (10k), replicate/cog (9.5k), woodpecker-ci/woodpecker (8.0k), unkeyed/unkey (5.5k), tsuru/tsuru (5.3k), loft-sh/devspace (5.2k), nicholas-fedor/watchtower (4.6k), runfinch/finch (4.1k), genuinetools/img (4.0k), okteto/okteto (3.6k), openfaas/faasd (3.3k), envoyproxy/gateway (3.1k), inspektor-gadget/inspektor-gadget (2.9k), gitlab-org/gitlab-runner on GitLab (2.6k), aws/eks-anywhere (2.1k), apptainer/apptainer (2.0k), kimdre/doco-cd (1.7k), containerd/stargz-snapshotter (1.6k).
- Consumers: buildx, compose, buildkit, go-containerregistry, mcp-gateway,
-
cli/config/types- Consumers: buildx, compose, buildkit, go-containerregistry.
- Importers: portainer/portainer (39k), aquasecurity/trivy (39k), istio/istio (38k), kubesphere/kubesphere (17k), hashicorp/nomad (17k), dagger/dagger (16k), GoogleContainerTools/skaffold (16k), loft-sh/devpod (15k), loft-sh/vcluster (11k), containerd/nerdctl (10k), replicate/cog (9.5k), woodpecker-ci/woodpecker (8.0k), getarcaneapp/arcane (7.9k), unkeyed/unkey (5.5k), tsuru/tsuru (5.3k), loft-sh/devspace (5.2k), werf/werf (4.7k), alexellis/arkade (4.6k), nicholas-fedor/watchtower (4.6k), genuinetools/img (4.0k), okteto/okteto (3.6k), gardener/gardener (3.5k), digitalocean/doctl (3.5k), envoyproxy/gateway (3.1k), inspektor-gadget/inspektor-gadget (2.9k), gitlab-org/gitlab-runner on GitLab (2.6k), apptainer/apptainer (2.0k), kimdre/doco-cd (1.7k), genuinetools/reg (1.7k).
-
cli/connhelper- Consumers: model-runner.
- Importers: nektos/act (72k), traefik/traefik (65k), wagoodman/dive (55k), GoogleContainerTools/skaffold (16k), yusing/godoxy (4.2k), DataDog/datadog-agent (3.8k), buildpacks/pack (3.0k).
-
cli/connhelper/commandconn- Consumers: buildkit.
- Importers: dagger/dagger (16k), psviderski/uncloud (5.5k), docker/docker-agent (4.4k).
-
cli/context- Consumers: buildx.
- Importers: none.
-
cli/context/docker- Consumers: buildx, compose, model-runner.
- Importers: wagoodman/dive (55k), jesseduffield/lazydocker (53k), kubernetes/minikube (32k), replicate/cog (9.5k), zarf-dev/zarf (2.1k).
-
cli/context/store- Consumers: buildx, compose.
- Importers: wagoodman/dive (55k), jesseduffield/lazydocker (53k), kubernetes/minikube (32k), replicate/cog (9.5k), kimdre/doco-cd (1.7k).
-
cli/debug- Consumers: buildx,
cmd/docker-trust. - Importers: none.
- Consumers: buildx,
-
cli/flags- Consumers: buildx, compose, testcontainers-go, model-runner, mcp-gateway,
cmd/docker-trust. - Importers: portainer/portainer (39k), aquasecurity/trivy (39k), keploy/keploy (19k), tilt-dev/tilt (10k), alibaba/higress (9.6k), getarcaneapp/arcane (7.9k), k3d-io/k3d (6.6k), psviderski/uncloud (5.5k), werf/werf (4.7k), nicholas-fedor/watchtower (4.6k), docker/docker-agent (4.4k), ddev/ddev (3.9k), supabase/cli (2.4k), shellhub-io/shellhub (2.1k), zarf-dev/zarf (2.1k), kimdre/doco-cd (1.7k), datastack-net/dockerized (1.3k).
- Consumers: buildx, compose, testcontainers-go, model-runner, mcp-gateway,
-
cli/streams- Consumers: buildx, compose,
cmd/docker-trust. - Importers: psviderski/uncloud (5.5k), loft-sh/devspace (5.2k), ovh/cds (4.8k), ddev/ddev (3.9k), supabase/cli (2.4k), sealerio/sealer (2.1k), iximiuz/cdebug (1.7k).
- Consumers: buildx, compose,
-
cli-plugins/hooks- Consumers: compose.
- Importers: none.
-
cli-plugins/manager- Consumers: compose, mcp-gateway.
- Importers: ddev/ddev (3.9k).
-
cli-plugins/metadata- Consumers: buildx, compose, model-runner,
cmd/docker-trust. - Importers: docker/docker-agent (4.4k).
- Consumers: buildx, compose, model-runner,
-
cli-plugins/plugin- Consumers: buildx, compose, model-runner, mcp-gateway,
cmd/docker-trust. - Importers: docker/docker-agent (4.4k).
- Consumers: buildx, compose, model-runner, mcp-gateway,
-
opts- Consumers: buildx, compose,
cmd/docker-trust. - Importers: nektos/act (72k), siderolabs/talos (11k), containerd/nerdctl (10k), tilt-dev/tilt (10k), getarcaneapp/arcane (7.9k), k3d-io/k3d (6.6k), psviderski/uncloud (5.5k), moncho/dry (3.3k), gitlab-org/gitlab-runner on GitLab (2.6k), kimdre/doco-cd (1.7k).
- Consumers: buildx, compose,
-
pkg/kvfile- Consumers: compose.
- Importers: none.
Public only because other packages use them
None of the checked consumers import these directly.
Of these, only cli/config/credentials appears in the exported API of the packages above.
-
cli/config/credentials- Must stay public as long as
configfiledoes, becauseConfigFile.GetCredentialsStorereturnscredentials.Store. - Importers: nektos/act (72k), nicholas-fedor/watchtower (4.6k), aws/eks-anywhere (2.1k), kimdre/doco-cd (1.7k).
- Must stay public as long as
-
cli/config/memorystore- Importers: none.
-
cli/connhelper/ssh- Importers: none.
-
cli/command/formatter/tabwriter- Importers: none.
-
cli/hints- Importers: none.
-
cli/version- This is the
-Xldflags target inscripts/build/.variables; see the version-string item below. - Importers: ddev/ddev (3.9k).
- ddev sets
version.Versionat runtime to change the User-Agent. NewAPIClientFromFlagsalways usesUserAgent(), so ddev has no other way to do this today.
- This is the
-
cli-plugins/socket- Importers: none.
-
templates- Importers: containerd/nerdctl (10k), moncho/dry (3.3k).
- Plugins might want it for
--format.
Subcommand packages
cli/command/image already says "Do not import commands directly".
-
cli/command/builder- Importers: none.
-
cli/command/checkpoint- Importers: none.
-
cli/command/commands- Importers: werf/werf (4.7k).
-
cli/command/completion- Importers: none.
- Its shell-completion helpers might be useful to plugins.
-
cli/command/config- Importers: none.
-
cli/command/context- Importers: none.
-
cli/command/idresolver- Importers: none.
task.Printtakes anidresolver.IDResolver, so it must stay public as long astaskdoes.
-
cli/command/image- Importers: none.
-
cli/command/manifest- Importers: none.
-
cli/command/network- Importers: none.
-
cli/command/node- Importers: none.
-
cli/command/plugin- Importers: none.
-
cli/command/registry- Importers: none.
-
cli/command/secret- Importers: none.
-
cli/command/service- Importers: none.
-
cli/command/service/progress- Importers: offen/docker-volume-backup (4.1k), kimdre/doco-cd (1.7k).
-
cli/command/stack- Importers: none.
-
cli/command/swarm- Importers: none.
-
cli/command/swarm/progress- Importers: none.
-
cli/command/system- Importers: none.
-
cli/command/system/pruner- Importers: none.
-
cli/command/task- Importers: none.
-
cli/command/volume- Importers: none.
Legacy docker stack compose loader
loader, convert and types expose internal/volumespec types through aliases such as types.ServiceVolumeConfig = volumespec.VolumeConfig.
In practice, that makes those internal types public too.
-
cli/compose/loader- Importers: nektos/act (72k), portainer/portainer (39k), goodrain/rainbond (6.3k), buildpacks/pack (3.0k), supabase/cli (2.4k), kimdre/doco-cd (1.7k).
-
cli/compose/types- Importers: portainer/portainer (39k), goodrain/rainbond (6.3k), buildpacks/pack (3.0k), kimdre/doco-cd (1.7k).
- The
loaderandconvertAPIs use it.
-
cli/compose/convert- Importers: portainer/portainer (39k), kimdre/doco-cd (1.7k).
-
cli/compose/schema- Importers: portainer/portainer (39k), kimdre/doco-cd (1.7k).
-
cli/compose/schema/data- Importers: none.
-
cli/compose/interpolation- The
loaderAPI uses itsOptionstype. - Importers: none.
- The
-
cli/compose/template- The
loaderandinterpolationAPIs use itsMappingtype. - Importers: none.
- The
Other
-
cli/manifest/store- Its API uses types from
cli/manifest/types. - Importers: none.
- Its API uses types from
-
cli/manifest/types- Importers: none.
-
opts/swarmopts- Importers: none.
-
e2e/testutils- Importable but test-only.
- Importers: none.
-
cmd/docker/winresources- Contains only package documentation.
- Importers: none.
Related issues in this PR
-
-Xldflags path forcli/version- The path becomes
github.com/docker/cli/v29/cli/version, so it changes in 29.10.0 and again at every new major version. - Go silently ignores
-Xfor a symbol that doesn't exist, so a stale path produces a binary that reports the wrong version, with no error. - Homebrew and Void hard-code the old path, and Debian's docker-team rules build it from
CLI_PKG. - Nix, Arch and Alpine build with
make dynbinary, so they pick up the new path automatically. - If
cli/versionmoves tointernal/, do it in the same release so the path only changes once.
- The path becomes
- Ngôn ngữ chính
- Go
- Star
- 6.1k
- Fork
- 2.2k
- Merge trung bình
- 1 ngày 8 giờ
- Pull request đã merge (30 ngày)
- 62
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của docker/cli
-
Mode option in tmpfs volume is ignored when deployed via docker stack deployCó thể đã có người làm @locker95 đã nhận 15 ngày trước. Đang mởkind/bug status/0-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Maintainer thường phản hồi trong vòng 1 ngày
-
docker stack: text after an unbraced `$VAR` is dropped when it starts with `-`, `:-`, `?` or `:?`Có thể đã có người làm @sebxt đã nhận 28 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 87/100
Maintainer thường phản hồi trong vòng 1 ngày
-
filename completion on `docker load -i`Có thể đã có người làm @cra đã nhận 31 ngày trước. Đang mởkind/feature status/0-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
docker build treats uppercase HTTP(S) URLs as local pathsCó thể đã có người làm @TanvirTian đã nhận 38 ngày trước. Đang mởkind/bug status/0-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
Maintainer thường phản hồi trong vòng 1 ngày
-
`docker context export` writes a truncated tar archiveCó thể đã có người làm @2arian3 đã nhận 54 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 92/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
agent-review-finding chore
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
jordansmall/spindrift#7254 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
pg-sharding/spqr#3275 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
create_or_update_file rejects explicitly empty file contentCó thể đã có người làm @Elon-Jiang đã nhận hôm nay. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
github/github-mcp-server#3883 ·
Maintainer thường phản hồi trong vòng 4 ngày
-
feature
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
databricks/terraform-provider-databricks#6210 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
IBM-Cloud/terraform-provider-ibm#7115 ·
Maintainer thường phản hồi trong vòng 2 ngày