Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Site: new placeholders for nightly version, tag and unstable suffix #8939

Merged
merged 3 commits into from
Jun 26, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions site/bin/_lib.sh
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,11 @@ get_latest_version () {
# Creates a 'nightly' version of the documentation that points to the current versioned docs
# located at the root-level `/docs` directory.
create_nightly () {
local version
version="$(cat ../version.txt)"

echo " --> create nightly"
echo " ... version: ${version}"

# Remove any existing 'nightly' directory and recreate it
rm -rf build/versions/nightly/
Expand All @@ -108,6 +112,10 @@ create_nightly () {
mv build/versions/nightly/docs/mkdocs.yml build/versions/nightly
rm build/versions/nightly/docs/index-release.md

echo " ... replace version placeholders in versioned docs"
find build/versions/nightly/docs -name "*.md" -exec sed -i='' "s/::NESSIE_VERSION::/${version}/g" {} \;
find build/versions/nightly/docs -name "*.md" -exec sed -i='' "s/::NESSIE_DOCKER_SUFFIX::/-unstable:latest/g" {} \;

cd build/versions/

# Update version information within the 'nightly' documentation
Expand Down Expand Up @@ -314,8 +322,9 @@ release() {
echo " ... replace title in versioned mkdocs.yml"
sed -i'' -E "s/(^site_name:[[:space:]]+).*$/\1\"Nessie ${RELEASE_VERSION}\"/" "${target}/mkdocs.yml"

echo " ... replace version placeholder in versioned docs"
find "${target}" -name "*.md" -exec sed -i "s/::NESSIE_VERSION::/${RELEASE_VERSION}/g" {} \;
echo " ... replace version placeholders in versioned docs"
find "${target}" -name "*.md" -exec sed -i='' "s/::NESSIE_VERSION::/${RELEASE_VERSION}/g" {} \;
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to this SO question, the syntax -i='' should be portable across different OSes (just -i gives an error on macOS).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems to work, yes

find "${target}" -name "*.md" -exec sed -i='' "s/::NESSIE_DOCKER_SUFFIX::/:${RELEASE_VERSION}/g" {} \;

echo " ... adding release to nav.yml"
sed -i "s/ RELEASE_PLACEHOLDER_MARKER$/ RELEASE_PLACEHOLDER_MARKER\\n - Nessie ${RELEASE_VERSION}: '\!include build\\/versions\\/${RELEASE_VERSION}\\/mkdocs.yml'/" ./nav.yml
Expand Down
21 changes: 8 additions & 13 deletions site/in-dev/gc.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,14 +27,9 @@ databases.
for production use. Any JDBC compliant database can be used, but it must be created and the
schema initialized before running the Nessie GC tool.

## Running locally
## Running the standalone uber jar

The Nessie GC tool can be downloaded from the [GitHub
Releases](https://github.com/projectnessie/nessie/releases) page, for example:

```shell
curl -L -o nessie-gc.jar https://github.com/projectnessie/nessie/releases/download/nessie-::NESSIE_VERSION::/nessie-gc-::NESSIE_VERSION::.jar
```
Check download options in the [Nessie download page](../downloads/index.md).

To see the available commands and options, run:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's keep this line separate.


Expand Down Expand Up @@ -92,7 +87,7 @@ docker run --rm -e POSTGRES_USER=pguser -e POSTGRES_PASSWORD=mysecretpassword -e
Create the database schema if required:

```shell
docker run --rm ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION:: create-sql-schema \
docker run --rm ghcr.io/projectnessie/nessie-gc::NESSIE_DOCKER_SUFFIX:: create-sql-schema \
--jdbc-url jdbc:postgresql://127.0.0.1:5432/nessie_gc \
--jdbc-user pguser \
--jdbc-password mysecretpassword
Expand All @@ -101,16 +96,16 @@ docker run --rm ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION:: create-sql-sc
Now we can run the Nessie GC tool:

```shell
docker run --rm ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION:: gc \
docker run --rm ghcr.io/projectnessie/nessie-gc::NESSIE_DOCKER_SUFFIX:: gc \
--jdbc-url jdbc:postgresql://127.0.0.1:5432/nessie_gc \
--jdbc-user pguser \
--jdbc-password mysecretpassword
```

The GC tool has a great number of options, which can be seen by running `docker run --rm
ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION:: --help`. The main command is `gc`, which is followed by
subcommands and options. Check the available subcommands and options by running `docker run --rm
ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION:: gc --help`.
ghcr.io/projectnessie/nessie-gc::NESSIE_DOCKER_SUFFIX:: --help`. The main command is `gc`,
which is followed by subcommands and options. Check the available subcommands and options by running
`docker run --rm ghcr.io/projectnessie/nessie-gc::NESSIE_DOCKER_SUFFIX:: gc --help`.

## Running with Kubernetes

Expand Down Expand Up @@ -142,7 +137,7 @@ spec:
spec:
containers:
- name: nessie-gc
image: ghcr.io/projectnessie/nessie-gc:::NESSIE_VERSION::
image: ghcr.io/projectnessie/nessie-gc::NESSIE_DOCKER_SUFFIX::
args:
- gc
- --uri
Expand Down