From 0357cf8d2d505c94dc4106374034a64ecf10cf3b Mon Sep 17 00:00:00 2001 From: tamsin woo Date: Tue, 12 Mar 2024 16:53:26 -0700 Subject: [PATCH] post up! --- public/categories/index.html | 22 +- public/categories/index.xml | 4 +- public/categories/tutorial/index.html | 25 +- public/categories/tutorial/index.xml | 9 +- public/index.html | 24 +- public/index.xml | 9 +- .../images/hugo-helm-setup.svg | 601 ++++++++--------- .../images/hugo-minimal-pod-setup.svg | 584 ++++++++--------- public/posts/hugo-on-k8s-nginx/index.html | 614 ++++++++++++++++++ public/posts/hugo-on-k8s-nginx/ingress.yaml | 19 + public/posts/hugo-on-k8s-nginx/service.yaml | 17 + public/posts/hugo-on-k8s-nginx/site.yaml | 71 ++ public/posts/hugo-on-k8s-nginx/values.yaml | 28 + public/posts/index.html | 25 +- public/posts/index.xml | 9 +- public/posts/miniflux-rss/index.html | 4 +- public/sitemap.xml | 35 +- public/tags/flux/index.html | 20 +- public/tags/flux/index.xml | 14 +- public/tags/hugo/index.html | 112 ++++ public/tags/hugo/index.xml | 19 + public/tags/index.html | 34 +- public/tags/index.xml | 20 +- public/tags/k8s/index.html | 25 +- public/tags/k8s/index.xml | 9 +- public/tags/meta/index.html | 25 +- public/tags/meta/index.xml | 9 +- public/tags/miniflux/index.html | 4 +- public/tags/rss/index.html | 4 +- 29 files changed, 1680 insertions(+), 715 deletions(-) create mode 100644 public/posts/hugo-on-k8s-nginx/index.html create mode 100644 public/posts/hugo-on-k8s-nginx/ingress.yaml create mode 100644 public/posts/hugo-on-k8s-nginx/service.yaml create mode 100644 public/posts/hugo-on-k8s-nginx/site.yaml create mode 100644 public/posts/hugo-on-k8s-nginx/values.yaml create mode 100644 public/tags/hugo/index.html create mode 100644 public/tags/hugo/index.xml diff --git a/public/categories/index.html b/public/categories/index.html index 3e445f0..51176ee 100644 --- a/public/categories/index.html +++ b/public/categories/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
@@ -52,13 +52,13 @@ kubernetes is for girls

Categories

- + @@ -67,14 +67,14 @@ kubernetes is for girls
- - + +

it's estradiol.cloud!

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

@@ -99,7 +99,7 @@ kubernetes is for girls
- +
diff --git a/public/categories/index.xml b/public/categories/index.xml index a050bf2..d1790ce 100644 --- a/public/categories/index.xml +++ b/public/categories/index.xml @@ -6,12 +6,12 @@ Recent content in Categories on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 Tutorial https://estradiol.cloud/categories/tutorial/ - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 https://estradiol.cloud/categories/tutorial/ diff --git a/public/categories/tutorial/index.html b/public/categories/tutorial/index.html index 5ec1a2c..2238e7b 100644 --- a/public/categories/tutorial/index.html +++ b/public/categories/tutorial/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
@@ -52,13 +52,16 @@ kubernetes is for girls

Tutorial

- + @@ -67,14 +70,14 @@ kubernetes is for girls
- - + +

it's estradiol.cloud!

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

@@ -99,7 +102,7 @@ kubernetes is for girls
- +
diff --git a/public/categories/tutorial/index.xml b/public/categories/tutorial/index.xml index 69d1cca..0efcb02 100644 --- a/public/categories/tutorial/index.xml +++ b/public/categories/tutorial/index.xml @@ -6,8 +6,15 @@ Recent content in Tutorial on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i’m running. the k8s cluster is also a vanity project. because i don’t like software, i wanted a way to deploy my site that doesn’t involve much of it. this post is about that. + Miniflux for Self-Hosted RSS https://estradiol.cloud/posts/miniflux-rss/ diff --git a/public/index.html b/public/index.html index 7dbf7cd..52c4feb 100644 --- a/public/index.html +++ b/public/index.html @@ -7,7 +7,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -41,10 +41,10 @@ kubernetes is for girls
@@ -53,18 +53,22 @@ kubernetes is for girls
- + it's a website!

Recently

@@ -74,14 +78,14 @@ kubernetes is for girls
- - + +

it's estradiol.cloud!

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

diff --git a/public/index.xml b/public/index.xml index f582cf0..bdcb520 100644 --- a/public/index.xml +++ b/public/index.xml @@ -6,8 +6,15 @@ Recent content on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i’m running. the k8s cluster is also a vanity project. because i don’t like software, i wanted a way to deploy my site that doesn’t involve much of it. this post is about that. + Miniflux for Self-Hosted RSS https://estradiol.cloud/posts/miniflux-rss/ diff --git a/public/posts/hugo-on-k8s-nginx/images/hugo-helm-setup.svg b/public/posts/hugo-on-k8s-nginx/images/hugo-helm-setup.svg index 42ad254..703f6f3 100644 --- a/public/posts/hugo-on-k8s-nginx/images/hugo-helm-setup.svg +++ b/public/posts/hugo-on-k8s-nginx/images/hugo-helm-setup.svg @@ -1,27 +1,27 @@ - @@ -851,25 +851,28 @@ -

deploy w/ helm & bitnami/nginx

-
my laptoprepokuberneteswebingressservicepod(s)configMapgit-pullemptyDirnginx git push `kubectl apply` mounts mounts mounts pull - - +

deploy w/ helm & bitnami/nginx

+
my laptoprepokuberneteswebingressservicedeploymentconfigMappod(s)git-pullemptyDirinitnginx git push `helm upgrade` mounts mounts mounts mounts pull + + - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + diff --git a/public/posts/hugo-on-k8s-nginx/images/hugo-minimal-pod-setup.svg b/public/posts/hugo-on-k8s-nginx/images/hugo-minimal-pod-setup.svg index e2afe31..e941cba 100644 --- a/public/posts/hugo-on-k8s-nginx/images/hugo-minimal-pod-setup.svg +++ b/public/posts/hugo-on-k8s-nginx/images/hugo-minimal-pod-setup.svg @@ -1,27 +1,27 @@ - @@ -851,22 +851,24 @@ -

deploy w/ kubectl apply

-
my laptoprepokubernetespodconfigMapgit-pullemptyDirnginx git push `kubectl apply` mounts mounts mounts pull - - +

deploy w/ kubectl apply

+
my laptoprepokubernetespodconfigMapgit-pullemptyDirinitnginx git push `kubectl apply` mounts mounts mounts mounts pull + + - - - + + + - - + + + - - - + + + + diff --git a/public/posts/hugo-on-k8s-nginx/index.html b/public/posts/hugo-on-k8s-nginx/index.html new file mode 100644 index 0000000..2918f14 --- /dev/null +++ b/public/posts/hugo-on-k8s-nginx/index.html @@ -0,0 +1,614 @@ + + + + Hugo on Kubernetes & NGINX – estradiol.cloud + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ +
+ +
+
+

Hugo on Kubernetes & NGINX

+
+
+

i decided to make a website. a static one. this one. with Hugo. the +main reason i have for needing a website is as a vanity project, so i have some +stuff to host in a Kubernetes cluster i’m running. the k8s cluster is +also a vanity project.

+

because i don’t like software, i wanted a way to deploy my site that doesn’t +involve much of it. this post is about that.

+

Getting Started

+

i built my site by following the straight-forward +Getting Started guide in the Hugo documentation.

+

i did hugo new site estradiol.cloud. and then cd estradiol.cloud; git init. +and then i picked a ridiculous theme +“inspired by terminal ricing aesthetics”, installing it like git submodule add https://github.com/joeroe/risotto.git themes/risotto; echo "theme = 'risotto'" >> hugo.toml.1

+

at this point, my website is basically finished (i also changed the title in +hugo.toml). i probably won’t be putting anything on it, so there’s no point +fiddling with other details.

+

about deployment, the Hugo guide’s Basic Usage page has this +to offer:

+
+

Most of our users deploy their sites using a CI/CD workflow, where a push1 + +to their GitHub or GitLab repository triggers a build and deployment. Popular +providers include AWS Amplify, CloudCannon, Cloudflare Pages, GitHub Pages, +GitLab Pages, and Netlify.

+
    +
  1. The Git repository contains the entire project directory, typically excluding the +public directory because the site is built after the push.
    2. +
+
+

importantly, you can’t make a post about deploying this way. everyone deploys +this way. if i deploy this way, this site will have no content.

+

this approach also involves a build system somewhere that can run Hugo to +compile the code and assets and push them onto my host. i definitely +already need Hugo installed on my laptop if i’m going to post anything.2 +so now i’m running Hugo in two places. there’s surely going to be other +complex nonsense like webhooks involved.

+

diagram: deploy w/ GitHub Pages & Actions

+
+

and hang on. let’s look at this again:

+
+
    +
  1. The Git repository contains the entire project directory, typically excluding the +public directory because the site is built after the push.
    2. +
+
+

you’re telling me i’m going to build a nice static site and not check the +actual content into version control? couldn’t be me.

+

Getting Static

+

suppose i instead check my content in exactly as i intend to serve it? +then i could shell into my server box, pull the site, and nifty-galifty! isn’t +this the way it has always been done?

+

my problem is that i don’t have a server box. i have a container orchestration +system. there are several upsides to this3 but it means that somehow my +generated content needs to end up in a container. because Pods are +ephemeral and i’d like to run my site with horizontal scalability4, i don’t +want my container to retain runtime state across restarts or replicas.

+

i could run a little pipeline that builds a container image wrapping my +content and pushes it to a registry. when i deploy, the cluster pulls the +image, content and all. all ready to go. but now i’ve got software again: +build stages and webhooks and, to make matters worse, now i’m hosting +and versioning container images.

+

diagram: deploy w/ container build

+

i don’t want any of this. i just want to put some HTML and static assets behind a +web server.

+
+

instead, i’d like to deploy a popular container image from a public registry +and deliver my content to it continuously.

+

a minimal setup to achieve this might look like:

+
    +
  • a Pod with: +
      +
    • an nginx container to serve the content;
      • +
    • a git-pull sidecar that loops, pulling the content;
      • +
    • an initContainer to do the initial checkout;
      • +
    • an emptyDir volume to share between the containers.
      • +
    +
    • +
  • a ConfigMap to store the nginx config.
    • +
+

diagram: minimal pod/configmap setup

+

when a new Pod comes up, the initContainer mounts the +emptyDir at /www and clones the repository into it. i use +git sparse-checkout to avoid pulling repository contents i don’t want to serve +out:

+
# git-clone command
+git clone https://code.estradiol.cloud/tamsin/estradiol.cloud.git --no-checkout --branch trunk /tmp/www;
+cd /tmp/www;
+git sparse-checkout init --cone;
+git sparse-checkout set public;
+git checkout;
+shopt -s dotglob
+mv /tmp/www/* /www
+

for the sidecar, i script up a git pull loop:

+
# git-pull command
+while true; do
+  cd /www && git -c safe.directory=/www pull origin trunk
+  sleep 60
+done
+

and i create a ConfigMap with a server block to configure +nginx to use Hugo’s public/ as root:

+
# ConfigMap; data: default.conf
+server {
+  listen 80;
+  location / {
+    root   /www/public;
+    index  index.html;
+  }
+}
+

the rest of this is pretty much boilerplate:

+

+

+kubectl apply -f https://estradiol.cloud/posts/hugo-on-k8s/site.yaml +
# estradiol-cloud.yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  labels:
+    app.kubernetes.io/instance: estradiol-cloud
+    app.kubernetes.io/name: nginx
+  name: nginx-server-block
+data:
+  default.conf: |-
+    server {
+      listen 80;
+      location / {
+        root   /www/public;
+        index  index.html;
+      }
+    }
+---
+apiVersion: v1
+kind: Pod
+metadata:
+  name: nginx
+  labels:
+    app.kubernetes.io/instance: estradiol-cloud
+    app.kubernetes.io/name: nginx
+spec:
+  containers:
+  - name: nginx
+    image: nginx:1.25.4
+    ports:
+    - containerPort: 80
+    volumeMounts:
+    - mountPath: /www
+      name: www
+    - mountPath: /etc/nginx/conf.d
+      name: nginx-server-block
+  - name: git-pull
+    image: bitnami/git
+    command:
+    - /bin/bash
+    - -ec
+    - |
+      while true; do
+        cd /www && git -c safe.directory=/www pull origin trunk
+        sleep 60
+      done
+    volumeMounts:
+    - mountPath: /www
+      name: www
+  initContainers:
+  - name: git-clone
+    image: bitnami/git
+    command:
+    - /bin/bash
+    - -c
+    - |
+      shopt -s dotglob
+      git clone https://code.estradiol.cloud/tamsin/estradiol.cloud.git --no-checkout --branch trunk /tmp/www;
+      cd /tmp/www;
+      git sparse-checkout init --cone;
+      git sparse-checkout set public;
+      git checkout;
+      mv /tmp/www/* /www
+    volumeMounts:
+    - mountPath: /www
+      name: www
+  volumes:
+  - name: www
+    emptyDir: {}
+  - name: nginx-server-block
+    configMap:
+      name: nginx-server-block
+
+
+

+ +
+

my Hugo workflow now looks like:

+
    +
  1. make changes to source;
    2. +
  2. run hugo --gc --minify;5
    3. +
  3. git commit & push.
    4. +
+

my git pull control loop takes things over from here and i’m on easy street.

+

Getting Web

+

this is going great! my Pod is running. it’s serving out my code. i get +Continuous Deployment™ for the low price of 11 lines bash. i mean… +no one can actually browse to my website6 but that will be an easy fix, +right? yes. networking is always the easy part.

+

first, i need a Service. this gives me a proxy to my several +replicas7 and in-cluster service discovery.

+

+

+kubectl apply -f https://estradiol.cloud/posts/hugo-on-k8s-nginx/service.yaml +
# service.yaml
+apiVersion: v1
+kind: Service
+metadata:
+  labels:
+    app.kubernetes.io/instance: estradiol-cloud
+    app.kubernetes.io/name: nginx
+  name: nginx
+spec:
+  type: ClusterIP
+  selector:
+    app.kubernetes.io/instance: estradiol-cloud
+    app.kubernetes.io/name: nginx
+  ports:
+  - name: http
+    port: 80
+    protocol: TCP
+    targetPort: http
+
+
+

+ +

next, i need an Ingress to handle traffic inbound to the cluster +and direct it to the Service:

+

+

+kubectl apply -f https://estradiol.cloud/posts/hugo-on-k8s-nginx/ingress.yaml +
# ingress.yaml
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  labels:
+    app.kubernetes.io/instance: estradiol-cloud
+    app.kubernetes.io/name: nginx
+  name: nginx
+spec:
+  rules:
+  - host: estradiol.cloud
+    http:
+      paths:
+      - backend:
+          service:
+            name: nginx
+            port:
+              name: http
+        path: /
+        pathType: Prefix
+
+
+

+ +

this part expresses a routing rule: traffic reaching the cluster via +estradiol.cloud should go to my Service, and then to one of its backend Pods. +to actually apply this rule, i need an ingress controller. mine is +ingress-nginx.

+

when i deployed controller in my cluster, it created some more nginx Pods +in my cluster. these update their configuration dynamically based on the rules +in my Ingress resource(s). the controller also also creates a Service of +type LoadBalancer, which magically creates a load balancer appliance +in my cloud provider. off-screen, i can point DNS to that appliance to finish +the setup.

+

diagram: kubernetes ingress

+

you can tell it’s working by looking at your browser bar.

+
+

as this has come together, i’ve gotten increasingly anxious about how much +YAML i’ve had to write. this is a problem because YAML is software and, as +established, i’m hoping not to have much of that. it’s also annoying that most +of this YAML really is just boilerplate.

+

conveniently, Bitnami maintains a Helm Chart that templates +out all the boilerplate and does exactly what i’ve just been doing.8 i can +replace all my YAML with a call out to this chart and a few lines of +configuration, assuming i have helm client installed:

+

+

+helm upgrade --install --create-namespace --namespace estradiol-cloud -f https://estradiol.cloud/posts/hugo-on-k8s-nginx/values.yaml oci://registry-1.docker.io/bitnamicharts/nginx +
# values.yaml
+cloneStaticSiteFromGit:
+  enabled: true
+  repository: "https://code.estradiol.cloud/tamsin/estradiol.cloud.git"
+  branch: trunk
+  gitClone:
+    command:
+    - /bin/bash
+    - -ec
+    - |
+      [[ -f "/opt/bitnami/scripts/git/entrypoint.sh" ]] && source "/opt/bitnami/scripts/git/entrypoint.sh"
+      git clone {{ .Values.cloneStaticSiteFromGit.repository }} --no-checkout --branch {{ .Values.cloneStaticSiteFromGit.branch }} /tmp/app
+      [[ "$?" -eq 0 ]] && cd /tmp/app && git sparse-checkout init --cone && git sparse-checkout set public && git checkout && shopt -s dotglob && rm -rf /app/* && mv /tmp/app/* /app/
+ingress:
+  enabled: true
+  hostname: estradiol.cloud
+  ingressClassName: nginx
+  tls: true
+  annotations: {
+    cert-manager.io/cluster-issuer: letsencrypt-prod
+  }
+serverBlock: |-
+  server {
+    listen 8080;
+    root /app/public;
+    index index.html;
+  }
+service:
+  type: ClusterIP
+
+
+

+ +

diagram: helm setup

+

configuration for the git-clone script and our custom server block are added +via values.yaml. the git-pull loop configured by the chart works as-is. +by using the chart, we get a few other nicities. for instance, +my Pods are now managed by a Deployment.9 this will make my +grand scale-out plans a breeze.

+

Getting Flux’d

+

by now, i’m riding high. my whole setup is my static site code and <30 lines of +YAML.

+

i do have a bunch of stuff deployed into my cluster, and none of this is very +reproducible without all of that. my workflow has also expanded to:

+
    +
  1. for routine site deploys: +
      +
    1. make changes to source;
      2. +
    2. run hugo --gc --minify;5
      3. +
    3. git commit & push.
      4. +
    +
    2. +
  2. to update nginx, the chart version, or change config: +
      +
    1. make changes to values.yaml
      2. +
    2. helm upgrade
      3. +
    +
    3. +
+

i could do without the extra helm clientdependency on my laptop. i’m also +pretty git push-pilled, and i really want the solution to all my problems +to take the now familiar shape: put a control loop in my cluster and push +to a git repository.

+

enter flux.

+

with flux, i decide on a repository (and maybe a path within it) to act as +a source for my Kubernetes YAML. i go through a short bootstrap +process which installs the flux controllers and add them to repository. to +make a change to a resource in my cluster, i edit the YAML and push to the +repository. flux listens and applies the changes.

+

flux supports Helm deploys, so i can get that helm client off my laptop. +i can also use it to manage my ingress controller, cert-manager, flux +itself and whatever other infrastructural junk i may end up needing.

+

to move my web stack into flux, i create a HelmRepository resource for +the bitnami Helm charts:

+
# bitnami-helm.yaml
+apiVersion: source.toolkit.fluxcd.io/v1beta2
+kind: HelmRepository
+metadata:
+  name: bitnami
+  namespace: default
+spec:
+  url: https://charts.bitnami.com/bitnami
+

and add a HelmRelease pointing to the repository/chart version and containing +my values.yaml:

+

+

+release.yaml +
apiVersion: helm.toolkit.fluxcd.io/v2beta1
+kind: HelmRelease
+metadata:
+  name: web
+  namespace: estradiol-cloud
+spec:
+  interval: 5m
+  chart:
+    spec:
+      chart: nginx
+      version: '15.12.2'
+      sourceRef:
+        kind: HelmRepository
+        name: bitnami
+        namespace: default
+      interval: 1m
+  values:
+    cloneStaticSiteFromGit:
+      enabled: true
+      repository: "https://code.estradiol.cloud/tamsin/estradiol.cloud.git"
+      branch: trunk
+      gitClone:
+        command:
+          - /bin/bash
+          - -ec
+          - |
+            [[ -f "/opt/bitnami/scripts/git/entrypoint.sh" ]] && source "/opt/bitnami/scripts/git/entrypoint.sh"
+            git clone {{ .Values.cloneStaticSiteFromGit.repository }} --no-checkout --branch {{ .Values.cloneStaticSiteFromGit.branch }} /tmp/app
+            [[ "$?" -eq 0 ]] && cd /tmp/app && git sparse-checkout init --cone && git sparse-checkout set public && git checkout && shopt -s dotglob && rm -rf /app/* && mv /tmp/app/* /app/
+    ingress:
+      enabled: true
+      hostname: estradiol.cloud
+      ingressClassName: nginx
+      tls: true
+      annotations: {
+        cert-manager.io/cluster-issuer: letsencrypt-prod
+      }
+    serverBlock: |-
+      server {
+        listen 8080;
+        root /app/public;
+        index index.html;
+      }
+    service:
+      type: ClusterIP
+
+
+

+ +

when i push these to my flux source repository, the Helm +release rolls out.

+

diagram: flux git push/deploy sequence

+

A Note About Software

+

in the end, i’m forced to admit there’s still a lot of software involved in all +of this. setting aside the stuff that provisions and scales my cluster nodes, +and the magic LoadBalancer, i have:

+
    +
  • nginx (running from a stock image);
    • +
  • git & bash (running from a stock image);
    • +
  • a remote git server (i’m running gitea10, but github dot com is fine here);
    • +
  • Kubernetes (oops!); +
      +
    • flux, especially kustomize-controller and helm-controller;
      • +
    • ingress-nginx controller;
      • +
    • cert-manager and Let’s Encrypt;
      • +
    +
    • +
  • the bitnami/nginx Helm chart;
    • +
+

the bulk of this i’ll be able to reuse for the other things i deploy on the +cluster11. and it replaces SASS black-boxes like “AWS Amplify, CloudCannon, +Cloudflare Pages, GitHub Pages, GitLab Pages, and Netlify” in the recommended +Hugo deployment.

+

to actually deploy my site, i get to maintain a bash scripts for git-clone, my +NGINX config, and a couple of blobs of YAML.

+

at least there are no webhooks.

+
+

fin

+
+
+
    +
  1. +

    i appreciate the culinary branding. ↩︎

    +
    2. +
  2. +

    unlikely. ↩︎

    +
    3. +
  3. +

    few of which could be considered relevant for my project. ↩︎

    +
    4. +
  4. +

    i absolutely will not need this ↩︎

    +
    5. +
  5. +

    i added disableHTML = true and disableXML = true to [minify] +configuration in hugo.toml to keep HTML and RSS diffs readable. ↩︎ ↩︎

    +
    6. +
  6. +

    i can check that its working, at least, with a port-forward. ↩︎

    +
    7. +
  7. +

    lmao ↩︎

    +
    8. +
  8. +

    what incredible luck! (obviously, until now i’ve been working backward from this chart) ↩︎

    +
    9. +
  9. +

    i also snuck a TLS certificate configuration via Let’s Encrypt with +cert-manager into this iteration. if you’re following along at home and don’t have cert-manager installed, this should still work fine (but with no HTTPs). ↩︎

    +
    10. +
  10. +

    because i’m running gitea in my cluster and i want to avoid a circular +dependency for my flux source repository, i also depend on GitLab dot com. ↩︎

    +
    11. +
  11. +

    i won’t. ↩︎

    +
    12. +
+
+ +
+
+ +
+ +
+
+
+ + +

it's estradiol.cloud!

+

+

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

+
+
+

b 887 | 2

+

+
+ + + +
+
+
+

kubernetes is for girls

+ +

+ + 2024-03-12 +

+ + + +
+ Hugo on Kubernetes & NGINX: + + + +
+
+ +
+ +
+ + + diff --git a/public/posts/hugo-on-k8s-nginx/ingress.yaml b/public/posts/hugo-on-k8s-nginx/ingress.yaml new file mode 100644 index 0000000..410adcf --- /dev/null +++ b/public/posts/hugo-on-k8s-nginx/ingress.yaml @@ -0,0 +1,19 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + labels: + app.kubernetes.io/instance: estradiol-cloud + app.kubernetes.io/name: nginx + name: nginx +spec: + rules: + - host: estradiol.cloud + http: + paths: + - backend: + service: + name: nginx + port: + name: http + path: / + pathType: Prefix diff --git a/public/posts/hugo-on-k8s-nginx/service.yaml b/public/posts/hugo-on-k8s-nginx/service.yaml new file mode 100644 index 0000000..550038f --- /dev/null +++ b/public/posts/hugo-on-k8s-nginx/service.yaml @@ -0,0 +1,17 @@ +apiVersion: v1 +kind: Service +metadata: + labels: + app.kubernetes.io/instance: estradiol-cloud + app.kubernetes.io/name: nginx + name: nginx +spec: + type: ClusterIP + selector: + app.kubernetes.io/instance: estradiol-cloud + app.kubernetes.io/name: nginx + ports: + - name: http + port: 80 + protocol: TCP + targetPort: http diff --git a/public/posts/hugo-on-k8s-nginx/site.yaml b/public/posts/hugo-on-k8s-nginx/site.yaml new file mode 100644 index 0000000..e3cf497 --- /dev/null +++ b/public/posts/hugo-on-k8s-nginx/site.yaml @@ -0,0 +1,71 @@ +apiVersion: v1 +kind: ConfigMap +metadata: + labels: + app.kubernetes.io/instance: estradiol-cloud + app.kubernetes.io/name: nginx + name: nginx-server-block +data: + default.conf: |- + server { + listen 80; + location / { + root /www/public; + index index.html; + } + } +--- +apiVersion: v1 +kind: Pod +metadata: + name: nginx + labels: + app.kubernetes.io/instance: estradiol-cloud + app.kubernetes.io/name: nginx +spec: + containers: + - name: nginx + image: nginx:1.25.4 + ports: + - containerPort: 80 + volumeMounts: + - mountPath: /www + name: www + - mountPath: /etc/nginx/conf.d + name: nginx-server-block + - name: git-pull + image: bitnami/git + command: + - /bin/bash + - -ec + - | + while true; do + cd /www && git -c safe.directory=/www pull origin trunk + sleep 60 + done + volumeMounts: + - mountPath: /www + name: www + initContainers: + - name: git-clone + image: bitnami/git + command: + - /bin/bash + - -c + - | + shopt -s dotglob + git clone https://code.estradiol.cloud/tamsin/estradiol.cloud.git --no-checkout --branch trunk /tmp/www; + cd /tmp/www; + git sparse-checkout init --cone; + git sparse-checkout set public; + git checkout; + mv /tmp/www/* /www + volumeMounts: + - mountPath: /www + name: www + volumes: + - name: www + emptyDir: {} + - name: nginx-server-block + configMap: + name: nginx-server-block diff --git a/public/posts/hugo-on-k8s-nginx/values.yaml b/public/posts/hugo-on-k8s-nginx/values.yaml new file mode 100644 index 0000000..0b88138 --- /dev/null +++ b/public/posts/hugo-on-k8s-nginx/values.yaml @@ -0,0 +1,28 @@ +cloneStaticSiteFromGit: + enabled: true + repository: "https://code.estradiol.cloud/tamsin/estradiol.cloud.git" + branch: trunk + gitClone: + command: + - /bin/bash + - -ec + - | + [[ -f "/opt/bitnami/scripts/git/entrypoint.sh" ]] && source "/opt/bitnami/scripts/git/entrypoint.sh" + git clone {{ .Values.cloneStaticSiteFromGit.repository }} --no-checkout --branch {{ .Values.cloneStaticSiteFromGit.branch }} /tmp/app + [[ "$?" -eq 0 ]] && cd /tmp/app && git sparse-checkout init --cone && git sparse-checkout set public && git checkout && shopt -s dotglob && rm -rf /app/* && mv /tmp/app/* /app/ +ingress: + enabled: true + hostname: estradiol.cloud + ingressClassName: nginx + tls: true + annotations: { + cert-manager.io/cluster-issuer: letsencrypt-prod + } +serverBlock: |- + server { + listen 8080; + root /app/public; + index index.html; + } +service: + type: ClusterIP diff --git a/public/posts/index.html b/public/posts/index.html index 8a7630f..c3ea089 100644 --- a/public/posts/index.html +++ b/public/posts/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
@@ -52,13 +52,16 @@ kubernetes is for girls

Posts

- + @@ -67,14 +70,14 @@ kubernetes is for girls
- - + +

it's estradiol.cloud!

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

@@ -99,7 +102,7 @@ kubernetes is for girls
- +
diff --git a/public/posts/index.xml b/public/posts/index.xml index 72ff283..123c406 100644 --- a/public/posts/index.xml +++ b/public/posts/index.xml @@ -6,8 +6,15 @@ Recent content in Posts on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. + Miniflux for Self-Hosted RSS https://estradiol.cloud/posts/miniflux-rss/ diff --git a/public/posts/miniflux-rss/index.html b/public/posts/miniflux-rss/index.html index ca1dd0e..5a3a997 100644 --- a/public/posts/miniflux-rss/index.html +++ b/public/posts/miniflux-rss/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -123,7 +123,7 @@ bitnami chart), but using it in the existing chart required:

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

diff --git a/public/sitemap.xml b/public/sitemap.xml index 1c854ab..121a7ec 100644 --- a/public/sitemap.xml +++ b/public/sitemap.xml @@ -3,19 +3,34 @@ xmlns:xhtml="http://www.w3.org/1999/xhtml"> https://estradiol.cloud/ - 2024-03-13T08:25:00-07:00 - - https://estradiol.cloud/posts/ - 2024-03-13T08:25:00-07:00 + 2024-03-12T16:45:59-07:00 https://estradiol.cloud/categories/ - 2024-03-04T14:56:38-08:00 + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/tags/flux/ + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/tags/hugo/ + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + 2024-03-12T16:45:59-07:00 https://estradiol.cloud/tags/k8s/ - 2024-03-04T14:56:38-08:00 + 2024-03-12T16:45:59-07:00 https://estradiol.cloud/tags/meta/ - 2024-03-04T14:56:38-08:00 + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/posts/ + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/tags/ + 2024-03-12T16:45:59-07:00 + + https://estradiol.cloud/categories/tutorial/ + 2024-03-12T16:45:59-07:00 https://estradiol.cloud/tags/miniflux/ 2024-03-04T14:56:38-08:00 @@ -25,11 +40,5 @@ https://estradiol.cloud/tags/rss/ 2024-03-04T14:56:38-08:00 - - https://estradiol.cloud/tags/ - 2024-03-04T14:56:38-08:00 - - https://estradiol.cloud/categories/tutorial/ - 2024-03-04T14:56:38-08:00 diff --git a/public/tags/flux/index.html b/public/tags/flux/index.html index 0ec4c56..7e2deff 100644 --- a/public/tags/flux/index.html +++ b/public/tags/flux/index.html @@ -1,12 +1,12 @@ - Flux – estradiol.cloud + Flux – estradiol.cloud @@ -20,9 +20,9 @@ kubernetes is for girls - - - + + + @@ -39,10 +39,10 @@ kubernetes is for girls
@@ -56,7 +56,7 @@ kubernetes is for girls @@ -74,7 +74,7 @@ kubernetes is for girls

the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

-

kubernetes is for girls

+

b 887 | 2

@@ -84,7 +84,7 @@ kubernetes is for girls hachyderm.io/@no_reply
  • - chaosfem.tw/@t4tamsin + chaosfem.tw/@t4tamsin
  • code diff --git a/public/tags/flux/index.xml b/public/tags/flux/index.xml index 0c25148..0caa08c 100644 --- a/public/tags/flux/index.xml +++ b/public/tags/flux/index.xml @@ -2,18 +2,18 @@ Flux on estradiol.cloud - http://localhost:1313/tags/flux/ + https://estradiol.cloud/tags/flux/ Recent content in Flux on estradiol.cloud Hugo -- gohugo.io en-us - Wed, 28 Feb 2024 15:35:46 -0800 - + Tue, 12 Mar 2024 16:45:59 -0700 + Hugo on Kubernetes & NGINX - http://localhost:1313/posts/hugo-on-k8s-nginx/ - Wed, 28 Feb 2024 15:35:46 -0800 - http://localhost:1313/posts/hugo-on-k8s-nginx/ - i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, because i need some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. diff --git a/public/tags/hugo/index.html b/public/tags/hugo/index.html new file mode 100644 index 0000000..f2d226a --- /dev/null +++ b/public/tags/hugo/index.html @@ -0,0 +1,112 @@ + + + + Hugo – estradiol.cloud + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + +
    + +
    +

    Hugo

    + + + + + + +
    + +
    +
    +
    + + +

    it's estradiol.cloud!

    +

    +

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    +
    +
    +

    b 887 | 2

    +

    +
    + + + +
    +
    +
    + + +
    +
    + +
    + +
    + + + diff --git a/public/tags/hugo/index.xml b/public/tags/hugo/index.xml new file mode 100644 index 0000000..8ba3f6e --- /dev/null +++ b/public/tags/hugo/index.xml @@ -0,0 +1,19 @@ + + + + Hugo on estradiol.cloud + https://estradiol.cloud/tags/hugo/ + Recent content in Hugo on estradiol.cloud + Hugo -- gohugo.io + en-us + Tue, 12 Mar 2024 16:45:59 -0700 + + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. + + + diff --git a/public/tags/index.html b/public/tags/index.html index df03c59..3e55c8f 100644 --- a/public/tags/index.html +++ b/public/tags/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
    @@ -52,22 +52,28 @@ kubernetes is for girls

    Tags

    - + @@ -76,14 +82,14 @@ kubernetes is for girls
    - - + +

    it's estradiol.cloud!

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    -

    kubernetes is for girls

    +

    b 887 | 2

    @@ -108,7 +114,7 @@ kubernetes is for girls
    - +
    diff --git a/public/tags/index.xml b/public/tags/index.xml index 649eb07..495f1c4 100644 --- a/public/tags/index.xml +++ b/public/tags/index.xml @@ -6,19 +6,33 @@ Recent content in Tags on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Flux + https://estradiol.cloud/tags/flux/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/tags/flux/ + + + + Hugo + https://estradiol.cloud/tags/hugo/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/tags/hugo/ + + K8s https://estradiol.cloud/tags/k8s/ - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 https://estradiol.cloud/tags/k8s/ Meta https://estradiol.cloud/tags/meta/ - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 https://estradiol.cloud/tags/meta/ diff --git a/public/tags/k8s/index.html b/public/tags/k8s/index.html index 2c1e58f..e27fc28 100644 --- a/public/tags/k8s/index.html +++ b/public/tags/k8s/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
    @@ -52,13 +52,16 @@ kubernetes is for girls

    K8s

    - + @@ -67,14 +70,14 @@ kubernetes is for girls
    - - + +

    it's estradiol.cloud!

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    -

    kubernetes is for girls

    +

    b 887 | 2

    @@ -99,7 +102,7 @@ kubernetes is for girls
    - +
    diff --git a/public/tags/k8s/index.xml b/public/tags/k8s/index.xml index 6ecae89..5fabcd2 100644 --- a/public/tags/k8s/index.xml +++ b/public/tags/k8s/index.xml @@ -6,8 +6,15 @@ Recent content in K8s on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. + Miniflux for Self-Hosted RSS https://estradiol.cloud/posts/miniflux-rss/ diff --git a/public/tags/meta/index.html b/public/tags/meta/index.html index 2be8d6b..611f2bb 100644 --- a/public/tags/meta/index.html +++ b/public/tags/meta/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -40,10 +40,10 @@ kubernetes is for girls
    @@ -52,13 +52,16 @@ kubernetes is for girls

    Meta

    - + @@ -67,14 +70,14 @@ kubernetes is for girls
    - - + +

    it's estradiol.cloud!

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    -

    kubernetes is for girls

    +

    b 887 | 2

    @@ -99,7 +102,7 @@ kubernetes is for girls
    - +
    diff --git a/public/tags/meta/index.xml b/public/tags/meta/index.xml index a784eaf..02a5c44 100644 --- a/public/tags/meta/index.xml +++ b/public/tags/meta/index.xml @@ -6,8 +6,15 @@ Recent content in Meta on estradiol.cloud Hugo -- gohugo.io en-us - Mon, 04 Mar 2024 14:56:38 -0800 + Tue, 12 Mar 2024 16:45:59 -0700 + + Hugo on Kubernetes & NGINX + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + Tue, 12 Mar 2024 16:45:59 -0700 + https://estradiol.cloud/posts/hugo-on-k8s-nginx/ + i decided to make a website. a static one. this one. with Hugo. the main reason i have for needing a website is as a vanity project, so i have some stuff to host in a Kubernetes cluster i&rsquo;m running. the k8s cluster is also a vanity project. because i don&rsquo;t like software, i wanted a way to deploy my site that doesn&rsquo;t involve much of it. this post is about that. + Miniflux for Self-Hosted RSS https://estradiol.cloud/posts/miniflux-rss/ diff --git a/public/tags/miniflux/index.html b/public/tags/miniflux/index.html index 3095209..c68de7e 100644 --- a/public/tags/miniflux/index.html +++ b/public/tags/miniflux/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -74,7 +74,7 @@ kubernetes is for girls

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    -

    kubernetes is for girls

    +

    b 887 | 2

    diff --git a/public/tags/rss/index.html b/public/tags/rss/index.html index 563eeb2..5316d25 100644 --- a/public/tags/rss/index.html +++ b/public/tags/rss/index.html @@ -6,7 +6,7 @@ ---- -kubernetes is for girls +b 887 | 2 "> @@ -74,7 +74,7 @@ kubernetes is for girls

    the regrown limb can be monstrous, duplicated, potent. We have all been injured, profoundly.

    -

    kubernetes is for girls

    +

    b 887 | 2