feat: add guide for Komodo
This commit is contained in:
68
src/content/docs/guides/Komodo/update-hosts.mdx
Normal file
68
src/content/docs/guides/Komodo/update-hosts.mdx
Normal file
@@ -0,0 +1,68 @@
|
|||||||
|
---
|
||||||
|
title: Update Komodo Hosts
|
||||||
|
description: Steps followed to update the Periphery Agents on Komodo managed hosts.
|
||||||
|
hero:
|
||||||
|
tagline: Steps followed to update the Periphery Agents on Komodo managed hosts.
|
||||||
|
image:
|
||||||
|
file: https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/komodo.webp
|
||||||
|
---
|
||||||
|
|
||||||
|
import { Aside } from '@astrojs/starlight/components';
|
||||||
|
import { Steps } from '@astrojs/starlight/components';
|
||||||
|
|
||||||
|
<Aside type="tip">Find the latest documentation from Komodo [here](https://komo.do/docs/intro).</Aside>
|
||||||
|
<Aside type="tip">Find the local Application documentation [here](https://docs.alexlebens.dev/applications/komodo/).</Aside>
|
||||||
|
|
||||||
|
# Systemd hosts
|
||||||
|
|
||||||
|
These hosts are on the same network as Komodo and have direct access. For simplicity, they run as a [systemd](https://systemd.io/) service.
|
||||||
|
|
||||||
|
SSH to the host and run the following command. This command is repeatable and non-destructive and will update to the latest version.
|
||||||
|
````bash
|
||||||
|
curl -sSL https://raw.githubusercontent.com/moghtech/komodo/main/scripts/setup-periphery.py | python3 - \
|
||||||
|
--core-address="https://komodo.alexlebens.net"
|
||||||
|
````
|
||||||
|
|
||||||
|
# Docker hosts
|
||||||
|
|
||||||
|
These hosts are not on the network and need some kind of VPN connection, such as [Tailscale](https://tailscale.com/). Because of this requirement it becomes simpler to use containers and [Docker networks](https://docs.docker.com/engine/network/).
|
||||||
|
|
||||||
|
The hosts should have their [compose](https://docs.docker.com/compose/) files defined in the [infrastructure repository](https://gitea.alexlebens.dev/alexlebens/infrastructure/src/branch/main/hosts). Therefore, [Renovate](https://gitea.alexlebens.dev/alexlebens/infrastructure/actions?workflow=renovate.yaml&actor=0&status=0) will make updates to those files.
|
||||||
|
|
||||||
|
<Steps>
|
||||||
|
1. SSH to the host and switch user to root.
|
||||||
|
````bash
|
||||||
|
ssh <hostname>
|
||||||
|
````
|
||||||
|
|
||||||
|
2. Change directory to where the local git folder is. This can vary per host, but the default should be in the /opt/compose folder.
|
||||||
|
````bash
|
||||||
|
cd /opt/compose/infrastructure
|
||||||
|
````
|
||||||
|
|
||||||
|
3. Pull the latest changes.
|
||||||
|
````bash
|
||||||
|
git pull
|
||||||
|
````
|
||||||
|
|
||||||
|
4. Change directory to the host and Komodo app.
|
||||||
|
````bash
|
||||||
|
cd /opt/compose/infrastructure/hosts/<host>/komodo-periphery
|
||||||
|
````
|
||||||
|
|
||||||
|
5. Bring down the current stack.
|
||||||
|
````bash
|
||||||
|
docker compose down
|
||||||
|
````
|
||||||
|
|
||||||
|
5. Bring down the stack back up. This should pull the latest image.
|
||||||
|
````bash
|
||||||
|
docker compose up -d
|
||||||
|
````
|
||||||
|
|
||||||
|
6. Verify updates on the Komodo servers page.
|
||||||
|
````
|
||||||
|
[https://komodo.alexlebens.net/servers](https://komodo.alexlebens.net/servers)
|
||||||
|
````
|
||||||
|
</Steps>
|
||||||
|
|
||||||
Reference in New Issue
Block a user