feat: option to start a local docker registry by superewald · Pull Request #1601 · firecow/gitlab-ci-local

superewald · 2025-07-02T14:45:04Z

Adds the --registry option to gitlab-ci-local to run a local docker registry. This is useful if jobs build and push docker images using the CI_REGISTRY variable.

implementation

{gclRegistryPrefix} refers to Utils.gclRegistryPrefixand is set toregistry.gcl.local` currently.

starts a local docker registry prior to executing pipelines using registry:2 image if --registry was specified
1. creates self-signed ssl certificate using alpine/openssl and cache them in {gclRegistryPrefix}.certs volume
2. runs detached docker registry container configured to use the self-signed ssl certificate within their own network
configure gitlab-ci-local containers to use the local docker registry (as described in "container context")
after pipeline completed, stops and removes the local registry container (but not the network and volumes to avoid recreating the certificate and caching built images)

container context

Using the --registry flag will apply the following modifications to gitlab-ci-local job containers:

mount volume with self-signed certificates ({gclRegistryPrefix}.certs, mounted 2 times to support oci and docker cert paths)
change $CI_REGISTRY env var to {gclRegistryPrefix} before expanding variables
add $CI_REGISTRY_USER={gclRegistryPrefix}.user and $CI_REGISTRY_PASSWORD={gclRegistryPrefix}.pass env variables
attach the {gclRegistryPrefix}.net network for communicating with the local registry

Implements #1600

mathieufrh · 2025-09-11T08:34:48Z

Any news about this ?

firecow · 2026-01-19T12:27:08Z

Feel free to reopen if you get time to finish this PR @superewald

superewald · 2026-01-19T14:18:40Z

I didn't notice eslint complaining, pushed a fix for that as now the PR is feature-complete. Couldn't re-open the PR though (I'm assuming due to missing permissions), @firecow could you please re-open and merge when checks passed?

superewald · 2026-01-24T13:06:15Z

@firecow pr is ready for merge

This MR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Adoption](https://docs.renovatebot.com/merge-confidence/) | [Passing](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---|---|---| | [npm:gitlab-ci-local](https://github.com/firecow/gitlab-ci-local) | `4.64.1` → `4.65.1` | ![age](https://developer.mend.io/api/mc/badges/age/npm/gitlab-ci-local/4.65.1?slim=true) | ![adoption](https://developer.mend.io/api/mc/badges/adoption/npm/gitlab-ci-local/4.65.1?slim=true) | ![passing](https://developer.mend.io/api/mc/badges/compatibility/npm/gitlab-ci-local/4.64.1/4.65.1?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/gitlab-ci-local/4.64.1/4.65.1?slim=true) | MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot). **Proposed changes to behavior should be submitted there as MRs.** --- ### Release Notes <details> <summary>firecow/gitlab-ci-local (npm:gitlab-ci-local)</summary> ### [`v4.65.1`](https://github.com/firecow/gitlab-ci-local/releases/tag/4.65.1) [Compare Source](firecow/gitlab-ci-local@4.65.0...4.65.1) Fix automatic publishing **Full Changelog**: <firecow/gitlab-ci-local@4.65.0...4.65.1> ### [`v4.65.0`](https://github.com/firecow/gitlab-ci-local/releases/tag/4.65.0) [Compare Source](firecow/gitlab-ci-local@4.64.1...4.65.0) #### What's Changed - Major upgrade camelcase, p-map and terminal-link by [@firecow](https://github.com/firecow) in [#1714](firecow/gitlab-ci-local#1714) - Major upgrade chalk and start using chalk-template by [@firecow](https://github.com/firecow) in [#1715](firecow/gitlab-ci-local#1715) - fix: parsing of regex in rules:if clause by [@ANGkeith](https://github.com/ANGkeith) in [#1712](firecow/gitlab-ci-local#1712) - Major upgrade globby by [@firecow](https://github.com/firecow) in [#1716](firecow/gitlab-ci-local#1716) - Major upgrade jest by [@firecow](https://github.com/firecow) in [#1717](firecow/gitlab-ci-local#1717) - build(deps): bump qs and express in /examples/docker-compose-nodejs by [@dependabot](https://github.com/dependabot)\[bot] in [#1722](firecow/gitlab-ci-local#1722) - chore(deps): lock file maintenance all non-major by [@renovate](https://github.com/renovate)\[bot] in [#1719](firecow/gitlab-ci-local#1719) - chore(deps): lock file maintenance by [@renovate](https://github.com/renovate)\[bot] in [#1730](firecow/gitlab-ci-local#1730) - build(deps-dev): bump tar from 7.5.3 to 7.5.6 by [@dependabot](https://github.com/dependabot)\[bot] in [#1731](firecow/gitlab-ci-local#1731) - build(deps-dev): bump lodash from 4.17.21 to 4.17.23 by [@dependabot](https://github.com/dependabot)\[bot] in [#1732](firecow/gitlab-ci-local#1732) - feat: option to start a local docker registry by [@superewald](https://github.com/superewald) in [#1601](firecow/gitlab-ci-local#1601) - chore(deps): lock file maintenance all non-major by [@renovate](https://github.com/renovate)\[bot] in [#1733](firecow/gitlab-ci-local#1733) - Fix environment-scoped variables with matrix jobs by [@chonchiog](https://github.com/chonchiog) in [#1726](firecow/gitlab-ci-local#1726) - Fix flaky extra-host test by [@firecow](https://github.com/firecow) in [#1741](firecow/gitlab-ci-local#1741) - feat: support needs specified inside rules by [@firecow](https://github.com/firecow) in [#1743](firecow/gitlab-ci-local#1743) - build(deps-dev): bump symfony/process from 5.4.46 to 5.4.51 in /examples/docker-swarm-php by [@dependabot](https://github.com/dependabot)\[bot] in [#1735](firecow/gitlab-ci-local#1735) - chore(deps): lock file maintenance all non-major by [@renovate](https://github.com/renovate)\[bot] in [#1737](firecow/gitlab-ci-local#1737) - Fix flaky services and dependency-proxy tests by [@firecow](https://github.com/firecow) in [#1747](firecow/gitlab-ci-local#1747) - chore(deps): update all non-major by [@renovate](https://github.com/renovate)\[bot] in [#1746](firecow/gitlab-ci-local#1746) - Support GitLab ANSI section markers by [@firecow](https://github.com/firecow) in [#1740](firecow/gitlab-ci-local#1740) - Add automated release workflow by [@firecow](https://github.com/firecow) in [#1748](firecow/gitlab-ci-local#1748) - Fix rclone R2 config and simplify release workflow by [@firecow](https://github.com/firecow) in [#1749](firecow/gitlab-ci-local#1749) #### New Contributors - [@chonchiog](https://github.com/chonchiog) made their first contribution in [#1726](firecow/gitlab-ci-local#1726) **Full Changelog**: <firecow/gitlab-ci-local@4.64.1...4.65.0> </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this MR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this MR, check this box --- This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).

* feat: option to start local docker registry * fix linting errors * fix already exist check for container errors * run oci test container in privileged mode * fix $CI_REGISTRY[..] variable scopes * add wait-for-port check * fix eslint * fix eslint * fix(tests): use nocolor stream comparison

superewald added 4 commits July 2, 2025 15:58

feat: option to start local docker registry

987e19e

fix linting errors

2eaff16

fix already exist check for container errors

8f84b33

run oci test container in privileged mode

55765a4

superewald force-pushed the docker-registry branch from 931a930 to 55765a4 Compare July 2, 2025 14:50

superewald marked this pull request as draft July 2, 2025 21:01

fix $CI_REGISTRY[..] variable scopes

d3679eb

superewald marked this pull request as ready for review July 7, 2025 12:32

firecow reviewed Jul 8, 2025

View reviewed changes

Comment thread src/utils.ts

superewald added 3 commits November 21, 2025 17:57

add wait-for-port check

0df51aa

fix eslint

365afe1

Merge branch 'master' into docker-registry

90b94ef

firecow closed this Jan 19, 2026

fix eslint

ecb01bd

firecow reopened this Jan 20, 2026

fix(tests): use nocolor stream comparison

1fadcb3

firecow approved these changes Jan 26, 2026

View reviewed changes

firecow merged commit 085946c into firecow:master Jan 26, 2026
9 checks passed

superewald mentioned this pull request Feb 1, 2026

option to start a local docker registry #1600

Closed

Navigation Menu

feat: option to start a local docker registry - #1601

feat: option to start a local docker registry#1601
firecow merged 10 commits into
firecow:masterfrom
superewald:docker-registry

superewald commented Jul 2, 2025 •

edited

Loading

Uh oh!

Uh oh!

mathieufrh commented Sep 11, 2025

Uh oh!

firecow commented Jan 19, 2026

Uh oh!

superewald commented Jan 19, 2026

Uh oh!

superewald commented Jan 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

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

Uh oh!

implementation

container context

Uh oh!

Uh oh!

mathieufrh commented Sep 11, 2025

Uh oh!

firecow commented Jan 19, 2026

Uh oh!

superewald commented Jan 19, 2026

Uh oh!

superewald commented Jan 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

superewald commented Jul 2, 2025 •

edited

Loading