You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sourcelume.apache.org by "QAInsights (via GitHub)" <gi...@apache.org> on 2026/10/04 18:58:03 UTC
[PR] Docs: running the dev environment on Windows + CRLF-safe vendored clone [sourcelume-registry]
QAInsights opened a new pull request, #6:
URL: https://github.com/apache/sourcelume-registry/pull/6
## Summary
Dev-environment docs and setup for Windows contributors:
- `dev-support/README.md`: new **"Running on Windows"** section covering the three supported paths — WSL2 (recommended), Git Bash, and native PowerShell — with command equivalents for each bash snippet (`$env:` vars, `curl.exe`, `New-Item -Force`, `docker network connect`).
- `dev-support/setup.ps1`: new PowerShell port of `setup.sh` (shared network + vendoring + `.env` defaults) for native Windows development.
- `setup.sh` / `setup.ps1`: clone Atlas with `-c core.autocrlf=false`. Under Git for Windows' default `autocrlf=true`, the vendored checkout gets CRLF endings and every vendored bash script fails with `$'\r': command not found`. Verified live.
- `dev-support/README.md`: new **"Atlas images: options & trade-offs"** section — documents that no official prebuilt Atlas image exists (`apache/atlas` on Docker Hub is empty, 2.5.0 is source-only), what the vendored stack actually builds, and the realistic alternatives (`docker save`/`load` sharing, embedded single-container mode, `sburn/apache-atlas` caveats).
- Simplified the network-connect step to the fixed `atlas` container name; root `README.md` points Windows users at the new section.
Related dev@ thread: "registry - Ingest design proposal" — Windows verification report posted there.
#### Test plan
- [x] `setup.ps1` run natively on Windows 11 — vendored tooling + `.env` configured
- [x] Full documented path validated end to end on Windows: archive downloads (Git Bash), `atlas-base` build, complete Atlas 2.5.0 source build (49/49 modules, BUILD SUCCESS), `atlas`/`atlas-kafka` images rebuilt from fresh dist
- [x] `mvn verify -Pintegration-tests` against PR #5 head — IngestPipelineIT 5/5 + 116 unit tests green via Testcontainers
- [ ] Reviewer: markdown render check
Apache-ai: Yes
Generated-by: Devin (SWE-2 Max)
Reviewed-by: NaveenKumar Namachivayam
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For additional commands, e-mail: dev-help@sourcelume.apache.org
Re: [PR] Docs: running the dev environment on Windows + CRLF-safe vendored clone [sourcelume-registry]
Posted by "Jamie G." <ja...@gmail.com>.
Github issues :)
On Mon, Oct 5, 2026 at 8:51 AM raulcd (via GitHub) <gi...@apache.org> wrote:
>
>
> raulcd commented on PR #6:
> URL: https://github.com/apache/sourcelume-registry/pull/6#issuecomment-5993407739
>
> Not for this PR, probably a follow up but would it make sense to run the setup scripts on CI to validate we don't introduce breakage? The full Atlas source build is not worth it but we could try and think of alternatives, maybe having a pre built Atlas container could work? Which we could use for development.
> @jgoodyear are we using JIRA tickets or should we use GitHub issues to track things?
>
>
> --
> This is an automated message from the Apache Git Service.
> To respond to the message, please log on to GitHub and use the
> URL above to go to the specific comment.
>
> To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
>
> For queries about this service, please contact Infrastructure at:
> users@infra.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
> For additional commands, e-mail: dev-help@sourcelume.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For additional commands, e-mail: dev-help@sourcelume.apache.org
Re: [PR] Docs: running the dev environment on Windows + CRLF-safe vendored clone [sourcelume-registry]
Posted by "jgoodyear (via GitHub)" <gi...@apache.org>.
jgoodyear commented on PR #6:
URL: https://github.com/apache/sourcelume-registry/pull/6#issuecomment-5993468674
Thank you NKN! :)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For additional commands, e-mail: dev-help@sourcelume.apache.org
Re: [PR] Docs: running the dev environment on Windows + CRLF-safe vendored clone [sourcelume-registry]
Posted by "raulcd (via GitHub)" <gi...@apache.org>.
raulcd commented on PR #6:
URL: https://github.com/apache/sourcelume-registry/pull/6#issuecomment-5993407739
Not for this PR, probably a follow up but would it make sense to run the setup scripts on CI to validate we don't introduce breakage? The full Atlas source build is not worth it but we could try and think of alternatives, maybe having a pre built Atlas container could work? Which we could use for development.
@jgoodyear are we using JIRA tickets or should we use GitHub issues to track things?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For additional commands, e-mail: dev-help@sourcelume.apache.org
Re: [PR] Docs: running the dev environment on Windows + CRLF-safe vendored clone [sourcelume-registry]
Posted by "jgoodyear (via GitHub)" <gi...@apache.org>.
jgoodyear merged PR #6:
URL: https://github.com/apache/sourcelume-registry/pull/6
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@sourcelume.apache.org
For additional commands, e-mail: dev-help@sourcelume.apache.org