Retarget getting-started guides to the control-repo template - #445
Merged
Conversation
miharp
force-pushed
the
docs/control-repo-template
branch
2 times, most recently
from
August 15, 2026 14:22
751420d to
e3bbcab
Compare
tuxmea
reviewed
Aug 20, 2026
| template, which provides a well-structured starting point: | ||
| Start from the | ||
| [OpenVoxProject/control-repo-template](https://github.com/OpenVoxProject/control-repo-template) | ||
| template, which provides a well-structured starting point built for OpenVox. |
Contributor
There was a problem hiding this comment.
Does this reads as "OpenVoxProject/control-repo-template template"? Maybe omit one "template" word.
miharp
force-pushed
the
docs/control-repo-template
branch
2 times, most recently
from
August 20, 2026 13:45
257757b to
6a9ed11
Compare
Point both guides at OpenVoxProject/control-repo-template instead of telling users to clone or fork puppetlabs/control-repo. The template's default branch is already production, so drop the branch-renaming caveat. Rework the crafty local guide's control-repo flow: the openvoxserver image never ran r10k on startup (the R10K_REMOTE variable in the oss compose file is unused), so deploy the code directory with the voxpupuli/r10k container before starting the server, matching crafty's own r10k example. Running r10k first also means the very first agent run reports the config_version from the deployed commit. Flow verified end-to-end against the live template with Docker. The _openvox_9x copies pick up the same change via the cutover content-drift port step (OpenVoxProject#430). Part of OpenVoxProject#444 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
miharp
force-pushed
the
docs/control-repo-template
branch
from
August 20, 2026 14:22
de12a63 to
4374eb1
Compare
tuxmea
approved these changes
Aug 20, 2026
tuxmea
enabled auto-merge
August 20, 2026 19:45
tuxmea
disabled auto-merge
August 20, 2026 19:46
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of #444
Points both getting-started guides at OpenVoxProject/control-repo-template instead of telling users to clone or fork puppetlabs/control-repo.
getting_started.markdown
production.getting_started_local.markdown
R10K_REMOTE. Theopenvoxserver:latestimage has no r10k entrypoint logic, so that flow never deployed anything (details in Switch getting-started guides to OpenVoxProject/control-repo-template #444).ghcr.io/voxpupuli/r10kcontainer to populate./openvox-codebefore the server starts (also gives the code directory the right ownership), Step 2 starts the stack, Step 3 enrolls the agent, and Step 4's iterate loop re-runs the same r10k container.config_version(puppet-production-<commit>); the guide now shows that output.Verification
Full flow tested live with Docker against the real template: r10k deploy → stack up → agent enroll/apply (
Applied catalog, correct config_version on first run) → push-change iterate loop → teardown.Console output: r10k deploy, stack health, first agent run
One-shot r10k container deploying the template into
./openvox-code:Stack health after
docker compose --profile openvox up -d:First agent run — pluginsync distributes the template's custom facts, types, and
functions, and the catalog applies with the
config_versionof the deployed commit:The three Facter warnings come from the template's cross-platform example
external facts running in a minimal Linux container (a
.ps1fact on Linux, andno
python/rubyon the agent's PATH) — harmless, and gone on real nodes withthose runtimes present.
bundle exec jekyll buildpasses; touched files are markdownlint-clean.The
_openvox_9xcopies of both pages (currently identical, added on #430) pick up this change via the cutover content-drift port step.Written with AI assistance (Claude); reviewed and tested by a human.