diff options
-rw-r--r-- | content/docs/adyxax.org/_index.md | 2 | ||||
-rw-r--r-- | content/docs/adyxax.org/git.md (renamed from content/docs/adyxax.org/services/git.md) | 14 | ||||
-rw-r--r-- | content/docs/adyxax.org/nethack.md (renamed from content/docs/adyxax.org/services/nethack.md) | 10 | ||||
-rw-r--r-- | content/docs/adyxax.org/services/_index.md | 8 | ||||
-rw-r--r-- | content/docs/adyxax.org/services/checkmk.md | 16 | ||||
-rw-r--r-- | content/docs/adyxax.org/services/www.md | 47 | ||||
-rw-r--r-- | content/docs/adyxax.org/www.md | 53 |
7 files changed, 67 insertions, 83 deletions
diff --git a/content/docs/adyxax.org/_index.md b/content/docs/adyxax.org/_index.md index ea9b904..51a8161 100644 --- a/content/docs/adyxax.org/_index.md +++ b/content/docs/adyxax.org/_index.md @@ -20,5 +20,5 @@ As a system and network administrator I believe I have a deep understanding of l On a personal note I also believe there are way too many blogs that focus on the hello world aspects and quick and dirty deployments that show up in google results, I will try to change that a bit. Writing about the choices I made will also help me reflect on them as this infrastructure evolves and grows. -## Subsections +## Services diff --git a/content/docs/adyxax.org/services/git.md b/content/docs/adyxax.org/git.md index a7a9374..5b90588 100644 --- a/content/docs/adyxax.org/services/git.md +++ b/content/docs/adyxax.org/git.md @@ -1,20 +1,21 @@ --- title: "git" -weight: 1 -description: > - adyxax.org git server +description: adyxax.org git server --- -git.adyxax.org is a gitea instance. For about 10 years I used a gitolite installation but I finally went for a gui instead in order to host repositories for non tech people. +## Introduction + +git.adyxax.org is a [gitea](https://gitea.io/) instance. For about 10 years I used a gitolite installation but I finally went for a gui instead in order to host repositories for non tech people. ## Preparing the postgresql database -I am currently hosting this gitea instance on an OpenBSD server. Obviously postgresql is packaged on this system so the installation is as simple as : +I am currently hosting this instance on an OpenBSD server. Obviously postgresql is packaged on this system so the installation is as simple as : {{< highlight sh >}} pkg_add postgresql-server su - __postgresql mkdir /var/postgresql/data initdb -D /var/postgresql/data -U postgres -A scram-sha-256 -E UTF8 -W +exit rcctl enable postgresql rcctl start postgresql su - ___postgresql @@ -35,8 +36,9 @@ rcctl enable gitea rcctl start gitea {{< /highlight >}} -## TODO Serving the website +## Serving the website +TODO {{< highlight sh >}} nvim /etc/h2o/h2o.conf {{< /highlight >}} diff --git a/content/docs/adyxax.org/services/nethack.md b/content/docs/adyxax.org/nethack.md index e9aa7a7..095f0ca 100644 --- a/content/docs/adyxax.org/services/nethack.md +++ b/content/docs/adyxax.org/nethack.md @@ -1,11 +1,12 @@ --- title: "nethack" -linkTitle: "nethack" -weight: 1 -description: > - nethack +description: nethack.adyxax.org game server --- +## Introduction + +I am hosting a private nethack game server accessible via ssh for anyone who will send me a ssh public key. It all runs chrooted on an OpenBSD server. + ## dgamelaunch TODO @@ -53,4 +54,3 @@ mount -R /dev /opt/nethack/dev gdb chroot run --userspec=nethack:games /opt/nethack/ /dgamelaunch {{< /highlight >}} - diff --git a/content/docs/adyxax.org/services/_index.md b/content/docs/adyxax.org/services/_index.md deleted file mode 100644 index 405c2ca..0000000 --- a/content/docs/adyxax.org/services/_index.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: "Services" -linkTitle: "Services" -weight: 1 -description: > - Here are the services provided by adyxax.org ---- - diff --git a/content/docs/adyxax.org/services/checkmk.md b/content/docs/adyxax.org/services/checkmk.md deleted file mode 100644 index f8a8bf6..0000000 --- a/content/docs/adyxax.org/services/checkmk.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: "checkmk" -linkTitle: "checkmk" -weight: 1 -description: > - checkmk ---- - -TODO - -## Updating - -- Download latest raw edition package from http://mathias-kettner.com/check_mk_download_version.php?HTML=yes&version=1.2.8p15&edition=cre and install it. -- `run omd backup adyxax adyxax.bak` -- `run omd update adyxax` -- If all went well, apt purge the previous check_mk version to free space. diff --git a/content/docs/adyxax.org/services/www.md b/content/docs/adyxax.org/services/www.md deleted file mode 100644 index 3f52e97..0000000 --- a/content/docs/adyxax.org/services/www.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "www" -linkTitle: "www" -weight: 1 -description: > - adyxax.org main entry website. www.adyxax.org, wiki.adyxax.org and blog.adyxax.org all point here. ---- - -This is the website you are currently reading. It is a static website built using [hugo](https://github.com/gohugoio/hugo). This article details how I -installed hugo, how I initialised this website and how I manage it. I often refer to it as wiki.adyxax.org because I hosted a unique dokuwiki for a long -time as my main website (and a pmwiki before that), but with hugo it has become more than that. It is now a mix of wiki, blog and showcase of my work and interests. - -For a log of how I made the initial setup, see [this blog article.]({{< relref "/blog/hugo/switching-to-hugo.md" >}}) - -## Installing hugo - -I am currently hosting this website on an OpenBSD server. Hugo is packaged on this system so the installation is as simple as : -{{< highlight sh >}} -pkg_add hugo--extended -{{< / highlight >}} - -## Bootstraping this site - -The website is on my gitea : -{{< highlight sh >}} -cd /var/www/htdocs -git clone --recurse-submodules _gitea@git.adyxax.org:adyxax/www.git -cd www -{{< / highlight >}} - -The docsy theme requires two nodejs programs to run : -{{< highlight sh >}} -npm install -D --save autoprefixer -npm install -D --save postcss-cli -{{< / highlight >}} - -## hugo commands - -To publish the website in the `public` folder : -{{< highlight sh >}} -hugo --minify -{{< / highlight >}} - -## TODO - -TODO deploy on push to git.adyxax.org -TODO web server config diff --git a/content/docs/adyxax.org/www.md b/content/docs/adyxax.org/www.md new file mode 100644 index 0000000..4c847fc --- /dev/null +++ b/content/docs/adyxax.org/www.md @@ -0,0 +1,53 @@ +--- +title: "www" +description: adyxax.org main website. www.adyxax.org, wiki.adyxax.org and blog.adyxax.org all point here. +--- + +## Introduction + +This is the website you are currently reading. It is a static website built using [hugo](https://github.com/gohugoio/hugo). This article details how I +installed hugo, how I initialised this website and how I manage it. I often refer to it as wiki.adyxax.org because this site replaces a dokuwiki I used for a long +time as my main website (and a pmwiki before that), but with [hugo]({{< ref "hugo" >}}) it has become more than that. It is now a mix of wiki, blog and showcase of my work and interests. + +For a log of how I made the initial setup, see [this blog article.]({{< ref "switching-to-hugo" >}}). Things are now simpler since I [wrote my own theme]({{< ref "ditching-the-heavy-hugo-theme" >}}). + +## Installing hugo + +I am currently hosting this website on an OpenBSD server. Hugo is packaged on this system so the installation is as simple as : +{{< highlight sh >}} +pkg_add hugo--extended +{{< / highlight >}} + +## Bootstraping this site + +The website is on my [gitea instance]({{< ref "git.md" >}}), and leaves under the standard `/var/www/htdocs` path: +{{< highlight sh >}} +cd /var/www/htdocs +git clone _gitea@git.adyxax.org:adyxax/www.git +cd www +{{< / highlight >}} + +To publish the website in the `public` folder I use a custom makefile so that I do not have to remind myself of hugo flags : +{{< highlight sh >}} +make build +{{< / highlight >}} + +## Automated deployment + +The deployment is automated with a simple `post-receive` git hook in the gitea repository : +{{< highlight sh >}} +#!/usr/bin/env bash +set -eu +unset GIT_DIR + +cd /var/www/htdocs/www/ +git remote update +git reset --hard origin/master +make build + +echo 'website updated' +{{< /highlight >}} + +## Web server config + +TODO |