From 81d010f9386daf2e9fb18be3c823d52875749542 Mon Sep 17 00:00:00 2001 From: Kelton Bassingthwaite Date: Sun, 18 Feb 2024 10:26:03 -0800 Subject: [PATCH] inital mdBook try --- .github/workflows/pages.yaml | 36 ++++++++++++++++++++++++++++++++++++ .gitignore | 3 +++ docs/book.toml | 6 ++++++ docs/index.md | 3 --- docs/src/SUMMARY.md | 3 +++ docs/src/secrets.md | 5 +++++ flake.lock | 12 ++++++------ flake.nix | 15 ++++++++------- 8 files changed, 67 insertions(+), 16 deletions(-) create mode 100644 .github/workflows/pages.yaml create mode 100644 docs/book.toml delete mode 100644 docs/index.md create mode 100644 docs/src/SUMMARY.md create mode 100644 docs/src/secrets.md diff --git a/.github/workflows/pages.yaml b/.github/workflows/pages.yaml new file mode 100644 index 0000000..bb88e73 --- /dev/null +++ b/.github/workflows/pages.yaml @@ -0,0 +1,36 @@ +name: Deploy Docs +on: + push: + branches: + - main + +jobs: + deploy: + runs-on: ubuntu-latest + permissions: + # contents: write # To push a branch + pages: write # To push to a GitHub Pages site + id-token: write # To update the deployment status + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + - name: Install latest mdbook + run: | + tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name') + url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz" + mkdir mdbook + curl -sSL $url | tar -xz --directory=./mdbook + echo `pwd`/mdbook >> $GITHUB_PATH + - name: Build Book + run: | + mdbook build docs + - name: Setup Pages + uses: actions/configure-pages@v2 + - name: Upload artifact + uses: actions/upload-pages-artifact@v1 + with: + path: 'docs/book' + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v1 diff --git a/.gitignore b/.gitignore index 1408ff7..d67abb9 100644 --- a/.gitignore +++ b/.gitignore @@ -22,3 +22,6 @@ cilium.yaml secrets.yaml vendor/ + +# mdBook +book/ diff --git a/docs/book.toml b/docs/book.toml new file mode 100644 index 0000000..ed80d77 --- /dev/null +++ b/docs/book.toml @@ -0,0 +1,6 @@ +[book] +authors = ["Kelton Bassingthwaite"] +language = "en" +multilingual = false +src = "src" +title = "Homelab Docs" diff --git a/docs/index.md b/docs/index.md deleted file mode 100644 index ae8a957..0000000 --- a/docs/index.md +++ /dev/null @@ -1,3 +0,0 @@ -# Documentation - -Testing Github pages docs. diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md new file mode 100644 index 0000000..8945fed --- /dev/null +++ b/docs/src/SUMMARY.md @@ -0,0 +1,3 @@ +# Summary + +- [Secrets](./secrets.md) diff --git a/docs/src/secrets.md b/docs/src/secrets.md new file mode 100644 index 0000000..4eae466 --- /dev/null +++ b/docs/src/secrets.md @@ -0,0 +1,5 @@ +# Secrets + +## Terraform Proxmox API + +## Kubernetes Sealed Secrets diff --git a/flake.lock b/flake.lock index d6145cd..0efcc52 100644 --- a/flake.lock +++ b/flake.lock @@ -5,11 +5,11 @@ "systems": "systems" }, "locked": { - "lastModified": 1694529238, - "narHash": "sha256-zsNZZGTGnMOf9YpHKJqMSsa0dXbfmxeoJ7xHlrt+xmY=", + "lastModified": 1705309234, + "narHash": "sha256-uNRRNRKmJyCRC/8y1RqBkqWBLM034y4qN7EprSdmgyA=", "owner": "numtide", "repo": "flake-utils", - "rev": "ff7b65b44d01cf9ba6a71320833626af21126384", + "rev": "1ef2e671c3b0c19053962c07dbda38332dcebf26", "type": "github" }, "original": { @@ -20,11 +20,11 @@ }, "nixpkgs": { "locked": { - "lastModified": 1697756275, - "narHash": "sha256-KAZ2F9He5oH2NPxhWDLmtGAsiBjPi7yps1OGZu6peMM=", + "lastModified": 1708232726, + "narHash": "sha256-DYuEHWQSBwaJkS2rjLUsKvGgDK8QIVojC3klAUw6uyk=", "owner": "NixOS", "repo": "nixpkgs", - "rev": "d042a296139c6a111be3e3d5dc9ef6783b5e7c16", + "rev": "35c5863c29ce81199ded8a3384f4979b7793f5dc", "type": "github" }, "original": { diff --git a/flake.nix b/flake.nix index 5e4eb33..24bdb93 100644 --- a/flake.nix +++ b/flake.nix @@ -22,19 +22,20 @@ pyPkgs.ansible-core pyPkgs.ansible pyPkgs.kubernetes - pkgs.ansible-lint - pkgs.opentofu pkgs.ansible-language-server - pkgs.talosctl - pkgs.kubectl - pkgs.kubeseal + pkgs.ansible-lint + pkgs.argocd pkgs.cilium-cli pkgs.jq - pkgs.yq-go - pkgs.argocd pkgs.jsonnet pkgs.jsonnet-bundler pkgs.just + pkgs.kubectl + pkgs.kubeseal + pkgs.mdbook + pkgs.opentofu + pkgs.talosctl + pkgs.yq-go ]; };