CVGreeter/welcome-to-codevalet-as-a-contributor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update upstream gitea refs.

Browse Source
This commit is contained in:
Nathan Trudeau
2026-04-29 08:37:09 -04:00
parent c8b4b0ce9a
commit 5e0b11f2cd
2 changed files with 13 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.env.example
View File

@@ -2,12 +2,12 @@
# fill in FORGE_GITEA_USERNAME. `.env` is gitignored. # fill in FORGE_GITEA_USERNAME. `.env` is gitignored.
# --- Gitea ----------------------------------------------------------- # --- Gitea -----------------------------------------------------------
FORGE_GITEA_URL="https://gitea.cvgitea.ddns.net:6006" FORGE_GITEA_URL="https://gitea.cvgitea.ddns.net"
FORGE_GITEA_ORG="codevalet" FORGE_GITEA_ORG="codevalet"
FORGE_GITEA_USERNAME="" FORGE_GITEA_USERNAME=""
# --- Orchestrator ---------------------------------------------------- # --- Orchestrator ----------------------------------------------------
FORGE_ORCHESTRATOR_REPO_URL="https://gitea.cvgitea.ddns.net:6006/codevalet/forge-stack-orchestrator.git" FORGE_ORCHESTRATOR_REPO_URL="https://gitea.cvgitea.ddns.net/codevalet/forge-stack-orchestrator.git"
# Leave empty for the repo's default branch. # Leave empty for the repo's default branch.
FORGE_ORCHESTRATOR_BRANCH="" FORGE_ORCHESTRATOR_BRANCH=""
# "." clones into ./forge-stack-orchestrator (gitignored by this repo). # "." clones into ./forge-stack-orchestrator (gitignored by this repo).

14
README.md
View File

@@ -1,6 +1,8 @@
# welcome-to-codevalet-as-a-contributor # welcome-to-codevalet-as-a-contributor
Onboarding for new contributors to the codevalet Gitea instance. Onboarding for new contributors to the codevalet Gitea instance.
The production Gitea host is published through the Pangolin HTTPS edge at
`https://gitea.cvgitea.ddns.net`.
Produces an authenticated local checkout of Produces an authenticated local checkout of
`forge-stack-orchestrator` with git operations against Gitea `forge-stack-orchestrator` with git operations against Gitea
authenticated silently through an OAuth2 (PKCE) token shared with the authenticated silently through an OAuth2 (PKCE) token shared with the
@@ -37,6 +39,7 @@ recipe runs `sudo` or installs anything system-wide.
A Gitea account on `FORGE_GITEA_URL` with membership in the A Gitea account on `FORGE_GITEA_URL` with membership in the
`codevalet` organisation is also required. `codevalet` organisation is also required.
Current production value: `https://gitea.cvgitea.ddns.net`.
## Configuring `.env` ## Configuring `.env`
@@ -45,9 +48,9 @@ edit is `FORGE_GITEA_USERNAME`. Defaults:
| Variable | Default | Change when | | Variable | Default | Change when |
| --- | --- | --- | | --- | --- | --- |
| `FORGE_GITEA_URL` | `https://gitea.cvgitea.ddns.net:6006` | different Gitea instance | | `FORGE_GITEA_URL` | `https://gitea.cvgitea.ddns.net` | different Gitea instance |
| `FORGE_GITEA_ORG` | `codevalet` | fork or sibling org | | `FORGE_GITEA_ORG` | `codevalet` | fork or sibling org |
| `FORGE_ORCHESTRATOR_REPO_URL` | `.../codevalet/forge-stack-orchestrator.git` | different fork | | `FORGE_ORCHESTRATOR_REPO_URL` | `https://gitea.cvgitea.ddns.net/codevalet/forge-stack-orchestrator.git` | different fork |
| `FORGE_ORCHESTRATOR_BRANCH` | *(empty: default branch)* | branch pin | | `FORGE_ORCHESTRATOR_BRANCH` | *(empty: default branch)* | branch pin |
| `FORGE_WORKSPACE_ROOT` | `.` (clone at `./forge-stack-orchestrator`, gitignored) | clone elsewhere | | `FORGE_WORKSPACE_ROOT` | `.` (clone at `./forge-stack-orchestrator`, gitignored) | clone elsewhere |
| `FSDGG_CLI_CLIENT_ID` | registered PKCE CLI client | never | | `FSDGG_CLI_CLIENT_ID` | registered PKCE CLI client | never |
@@ -63,6 +66,11 @@ loopback is not a meaningful option. On a shared or remote host,
SSH-forward the port (see *Headless and SSH hosts*) rather than SSH-forward the port (see *Headless and SSH hosts*) rather than
trying to publish the callback over the network. trying to publish the callback over the network.
`FORGE_GITEA_URL` is the canonical public HTTPS endpoint. Do not append
`:6006`; Pangolin terminates TLS on the public edge and the onboarding
repo, orchestrator clone URL, and global git credential scope all assume
the standard portless form.
`.env` is gitignored. OAuth client IDs are public by design; PKCE `.env` is gitignored. OAuth client IDs are public by design; PKCE
requires no client secret. requires no client secret.
@@ -205,7 +213,7 @@ with a browser to populate a valid refresh token before running
| --- | --- | | --- | --- |
| `just doctor` reports a missing tool | Run the `fix:` command printed beside it. | | `just doctor` reports a missing tool | Run the `fix:` command printed beside it. |
| `~/.local/bin` not on `PATH` | Add `export PATH="$HOME/.local/bin:$PATH"` to the shell rc and reopen. | | `~/.local/bin` not on `PATH` | Add `export PATH="$HOME/.local/bin:$PATH"` to the shell rc and reopen. |
| `just check-gitea` → connection refused | Verify `FORGE_GITEA_URL` and network access. | | `just check-gitea` → connection refused | Verify `FORGE_GITEA_URL`, confirm it is `https://gitea.cvgitea.ddns.net` for production, and do not append `:6006`. |
| `just login` → browser does not open | Run `just login-headless`. | | `just login` → browser does not open | Run `just login-headless`. |
| `just login` → timed out waiting for OAuth callback | Consent was not completed in the browser; re-run. | | `just login` → timed out waiting for OAuth callback | Consent was not completed in the browser; re-run. |
| `just login` → cannot bind `127.0.0.1:38111` | Another `just login` is running; wait or kill it. | | `just login` → cannot bind `127.0.0.1:38111` | Another `just login` is running; wait or kill it. |