Conversation
I believe large-runners are IP whitelisted
Trying to access the docs repo from the build is running into all sorts of problems. This repo is in cloudbees-oss, and docs is not, and there are various security measures in place. Duplicating docs isn't great, but it gets us to the value quickly instead of getting bogged down to details.
| # Run via: uv run poe update-docs | ||
| set -euo pipefail | ||
|
|
||
| REPO="git@github.com:cloudbees/docsite-cloudbees-smart-tests.git" |
There was a problem hiding this comment.
I’d like to update the documents automatically using something like a cron in Github Actions, but since his repo is private it seems difficult
There was a problem hiding this comment.
Exactly. I should have left this in comment somewhere -- I spent hours trying to do this as a part of the build process, but in the end I couldn't work around the IP restriction to access this Git repo.
There was a problem hiding this comment.
It's probably easier to do it as a push. Create a workflow in the internal repo, which deposits the doc bundle into this repo.
| @args4p.command(help="Copy product documentation into ./smart-tests-docs") | ||
| def docs(app: Application): | ||
| output = Path(OUTPUT_DIR) | ||
| if output.exists(): |
There was a problem hiding this comment.
nits: I don't have a strong opinion on this part, but why do executors remove docs directory. Cannot we just overwrite it?
There was a problem hiding this comment.
It's because files might be removed.
2 participants
I added a command to retrieve product documentation in the asciidocs format to the current directory.
This is a prerequisite for the AI agent skill that references product documentation