1 Commits

Author SHA1 Message Date
d27fae441d fix(deps): update dependency @catppuccin/starlight to v1.1.1
All checks were successful
renovate/stability-days Updates have met minimum release age requirement
test-build / build (pull_request) Successful in 3m4s
2026-01-28 00:08:42 +00:00
18 changed files with 651 additions and 646 deletions

View File

@@ -13,7 +13,7 @@ on:
jobs:
renovate:
runs-on: ubuntu-latest
container: ghcr.io/renovatebot/renovate:43
container: ghcr.io/renovatebot/renovate:42
steps:
- name: Checkout
uses: actions/checkout@v6

View File

@@ -1,5 +1,5 @@
ARG REGISTRY=docker.io
FROM ${REGISTRY}/node:24.13.0-alpine AS base
FROM ${REGISTRY}/node:24.13.0-alpine3.22 AS base
ENV PNPM_HOME="/pnpm"
ENV PATH="$PNPM_HOME:$PATH"
@@ -28,7 +28,7 @@ ENV HOST=0.0.0.0
ENV SITE_URL=https://docs.alexlebens.dev
ENV PORT=4321
LABEL version="0.1.0"
LABEL version="0.0.9"
LABEL description="Astro based documentation website"
EXPOSE $PORT

View File

@@ -1,4 +1,4 @@
# Starlight
# Starlight Starter Kit: Basics
[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
@@ -6,6 +6,8 @@
pnpm create astro@latest -- --template starlight
```
> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
## 🚀 Project Structure
Inside of your Astro + Starlight project, you'll see the following folders and files:
@@ -41,3 +43,7 @@ All commands are run from the root of the project, from a terminal:
| `pnpm preview` | Preview your build locally, before deploying |
| `pnpm astro ...` | Run CLI commands like `astro add`, `astro check` |
| `pnpm astro -- --help` | Get help using the Astro CLI |
## 👀 Want to learn more?
Check out [Starlights docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).

View File

@@ -4,7 +4,7 @@ import { defineConfig } from "astro/config";
import node from "@astrojs/node";
import tailwindcss from "@tailwindcss/vite";
import starlight from "@astrojs/starlight";
import starlightThemeRapide from 'starlight-theme-rapide'
import catppuccin from "@catppuccin/starlight";
const getSiteURL = () => {
if (process.env.SITE_URL) {
@@ -20,33 +20,32 @@ export default defineConfig({
integrations: [
tailwindcss(),
starlight({
title: "Alex Lebens Docs",
customCss: [
'./src/styles/custom.css',
],
title: "My Docs",
social: [
{
icon: "external",
label: "Homepage",
href: "https://www.alexlebens.dev",
icon: "github",
label: "GitHub",
href: "https://github.com/withastro/starlight",
},
],
plugins: [
starlightThemeRapide()
catppuccin({
dark: { flavor: "macchiato", accent: "sapphire" },
light: { flavor: "latte", accent: "sky" }
})
],
sidebar: [
{
label: "Guides",
items: [
// Each item here is one entry in the navigation menu.
{ label: "Example Guide", slug: "guides/example" },
],
},
{
label: "Reference",
autogenerate: { directory: "reference" },
},
{
label: "Guides",
autogenerate: { directory: "guides" },
},
{
label: "Applications",
autogenerate: { directory: "applications" },
},
],
}),
],

View File

@@ -1,7 +1,7 @@
{
"name": "site-documentation",
"type": "module",
"version": "0.1.0",
"version": "0.0.9",
"scripts": {
"dev": "astro dev",
"build": "astro build",
@@ -12,27 +12,27 @@
"astro": "astro"
},
"dependencies": {
"@astrojs/mdx": "^4.3.13",
"@astrojs/node": "^9.5.2",
"@astrojs/starlight": "^0.37.6",
"@astrojs/mdx": "4.3.13",
"@astrojs/node": "9.5.2",
"@astrojs/starlight": "^0.37.1",
"@catppuccin/starlight": "1.1.1",
"@tailwindcss/postcss": "^4.1.18",
"@tailwindcss/vite": "^4.1.18",
"astro": "^5.17.1",
"motion": "^12.33.0",
"astro": "5.16.15",
"motion": "^12.23.26",
"sanitize-html": "^2.17.0",
"sharp": "^0.34.5",
"starlight-theme-rapide": "^0.5.2",
"tailwindcss": "^4.1.18"
},
"devDependencies": {
"@tailwindcss/typography": "^0.5.19",
"@typescript-eslint/parser": "^8.54.0",
"eslint": "^10.0.0",
"eslint-config-prettier": "^10.1.8",
"eslint-plugin-astro": "^1.5.0",
"prettier": "^3.8.1",
"@typescript-eslint/parser": "8.53.1",
"eslint": "9.39.2",
"eslint-config-prettier": "10.1.8",
"eslint-plugin-astro": "1.5.0",
"prettier": "^3.7.4",
"prettier-plugin-astro": "^0.14.1",
"prettier-plugin-tailwindcss": "^0.7.2",
"typescript-eslint": "^8.54.0"
"typescript-eslint": "8.53.1"
}
}

1026
pnpm-lock.yaml generated

File diff suppressed because it is too large Load Diff

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 9.9 KiB

After

Width:  |  Height:  |  Size: 696 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 98 KiB

File diff suppressed because one or more lines are too long

Before

Width:  |  Height:  |  Size: 9.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 13 MiB

BIN
src/assets/houston.webp Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 96 KiB

View File

@@ -0,0 +1,11 @@
---
title: Example Guide
description: A guide in my new Starlight docs site.
---
Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
Writing a good guide requires thinking about what your users are trying to do.
## Further reading
- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework

View File

@@ -1,75 +0,0 @@
---
title: Talos Upgrade
description: Steps followed for the v1.12.0 upgrade process
---
The upgrade to this version was more extension as there have been migrations to using configuration documents. This required rewriting the configuration document to a series of patches and provide a deterministic generation command for the different host types. In addition there was also a change to storage layout to separate ceph, local-path, and ephemeral storage on the NUC hosts.
## Preparation
The NUC hosts are to be wiped since because of the storage reconfiguration. For the RPIs only the first command with proper image was needed. The new configuration format could be applied later. Both the node and the disks have to be removed.
The following command is used to upgrade the image. This was first to ensure the boot after wipe would still be v1.12.0 to use the updated configuration documents.
```bash
talosctl upgrade --nodes 10.232.1.23 --image factory.talos.dev/metal-installer/495176274ce8f9e87ed052dbc285c67b2a0ed7c5a6212f5c4d086e1a9a1cf614:v1.12.0
```
Wipe command.
```bash
talosctl reset --system-labels-to-wipe EPHEMERAL,STATE --reboot -n 10.232.1.23
```
## Remove old references
Remove the node from the cluster.
```bash
kubectl delete node talos-9vs-6hh
```
Exec into the rook-ceph-tools container in order to remove the disk from the cluster.
```bash
kubectl -n rook-ceph exec -it $(kubectl -n rook-ceph get pod -l "app=rook-ceph-tools" -o jsonpath='{.items\[\*].metadata.name}') -- bash
```
Inside the rook-ceph-tools container remove the OSD/disk and the node:
```bash
ceph osd tree
```
```bash
ceph osd out 0
```
```bash
ceph osd purge 0 --yes-i-really-mean-it
```
```bash
ceph osd crush remove talos-9vs-6hh
```
# Apply new configuration
The wiped node should now be in maintenance mode and ready to be configured. Use the generate command in the README of the talos-config repo to make the configuration to be supplied.
```bash
talosctl apply-config -f generated/worker-nuc.yaml -n 10.232.1.23 --insecure
```
Add the required labels if Talos does not add them:
```yaml
node-role.kubernetes.io/bgp: '65020'
node-role.kubernetes.io/local-storage-node: local-storage-node
node-role.kubernetes.io/rook-osd-node: rook-osd-node
```
## Verification
Verify the disks have been created:
```bash
talosctl get disks -n 10.232.1.23
```
Verify the mount paths and volumes are created:
```bash
talosctl -n 10.232.1.23 ls /var/mnt
```
```bash
talosctl -n 10.232.1.23 get volumestatuses
```

View File

@@ -1,30 +1,36 @@
---
title: Documentation for my Homelab
description: Guides and reference for my homelab infrastructure.
title: Welcome to Starlight
description: Get started building your docs site with Starlight.
template: splash
hero:
tagline: Guides and reference for my homelab infrastructure.
tagline: Congrats on setting up a new Starlight project!
image:
file: ../../assets/autumn_mountain.png
file: ../../assets/houston.webp
actions:
- text: Introduction
link: /reference/introduction/
- text: Example Guide
link: /guides/example/
icon: right-arrow
- text: Read the Starlight docs
link: https://starlight.astro.build
icon: external
variant: minimal
---
import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
import { Card, CardGrid } from '@astrojs/starlight/components';
## Hightlights
## Next steps
<CardGrid stagger>
<LinkCard
title="Homepage"
description="Visit my homepage to see what I'm up to and learn more about me."
href="https://www.alexlebens.dev"
></LinkCard>
<LinkCard
title="Read the Starlight docs"
description="This site is built with Starlight, the Astro documentation theme. Check out the docs to learn more."
href="https://starlight.astro.build/"
></LinkCard>
<Card title="Update content" icon="pencil">
Edit `src/content/docs/index.mdx` to see this page change.
</Card>
<Card title="Add new content" icon="add-document">
Add Markdown or MDX files to `src/content/docs` to create new pages.
</Card>
<Card title="Configure your site" icon="setting">
Edit your `sidebar` and other config in `astro.config.mjs`.
</Card>
<Card title="Read the docs" icon="open-book">
Learn more in [the Starlight Docs](https://starlight.astro.build/).
</Card>
</CardGrid>

View File

@@ -0,0 +1,11 @@
---
title: Example Reference
description: A reference page in my new Starlight docs site.
---
Reference pages are ideal for outlining how things work in terse and clear terms.
Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what you're documenting.
## Further reading
- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework

View File

@@ -1,16 +0,0 @@
---
title: Introduction
description: Overiew of the homelab
sidebar:
order: 1
---
Overview of the homelab.
# Hardware
Currently using a mix of RPIs, Intel based NUCs, Synology NAS, and Ubiquity networking.
# Software
Kubernetes for the main cluster. Docker managed by Komodo for the single hosts.

View File

@@ -1,34 +0,0 @@
@import 'tailwindcss';
@plugin '@tailwindcss/typography';
/* Custom colors */
@theme {
--color-midnight: #0c354d;
--color-turquoise: #0da797;
--color-steel: #4682b4;
--color-bermuda: #7fbab4;
--color-desert: #f9deb2;
--color-bronze: #9e7f5e;
--color-gitea-primary: #609926;
--color-gitea-secondary: #4c7a33;
}
@layer starlight, rapide, overrides;
@layer overrides {
:root {
--sl-color-accent-high: var(--color-steel);
--sl-color-accent-high: var(--color-steel);
--sl-color-accent-low: var(--color-bermuda);
}
:root[data-theme='light'] {
--sl-color-accent: var(--color-steel);
--sl-color-accent-high: var(--color-steel);
--sl-color-accent-low: var(--color-turquoise);
}
.site-title:where(.astro-gmuhlsjs) {
color: var(--color-turquoise);
}
}

View File

@@ -1,9 +1,7 @@
/** @type {import('tailwindcss').Config} */
module.exports = {
content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}', '*.{js,ts,jsx,tsx,mdx}'],
darkMode: ['class', '[data-theme="dark"]'],
theme: {
extend: {},
},
darkMode: 'class',
theme: {},
plugins: [require('@tailwindcss/typography')],
};