Added "New Traefik route" in Linux-Servers.md
This commit is contained in:
107
Linux-Servers.md
107
Linux-Servers.md
@@ -108,3 +108,110 @@ Change the SSL certificate setup so that future renewals will work.
|
||||
If not already done by completing the task before, repair the SSL connection so that "kipurchat.creature-go.com" can be used again.
|
||||
|
||||
|
||||
---
|
||||
|
||||
# Podman shell script for AFFiNE service
|
||||
|
||||
## Motivation
|
||||
|
||||
A Podman Pod is needed on a Linux server which provides an AFFiNE service.
|
||||
This Podman Pod needs to be created and started with a shell script which needs to be designed.
|
||||
|
||||
The AFFiNE service will be used by humans and by AI agents; it will also be part of a design environment for designing a special MCP server for AFFiNE.
|
||||
|
||||
## Shell script requirements
|
||||
|
||||
Requirements for the shell script:
|
||||
- Must use a container image with a Pinned Tag (for exact consistency) which points to the AFFiNE version 0.26.3. The name likely is something like "ghcr.io/toeverything/affine:0.26.3".
|
||||
- Must provide the AFFiNE web user interface at port 8092.
|
||||
- Must provide the GraphQL API. Background: The AFFiNE web and desktop apps use an internal GraphQL API to communicate with the backend. There is a /graphql endpoint but it is not documented for third-party use.
|
||||
- Must be in folder /home/pln/bin.
|
||||
- Must have the name create_pod_affine.sh
|
||||
|
||||
The shell script shall be run by user pln which has permissions to run rootless pods.
|
||||
|
||||
## Shell script style
|
||||
|
||||
The needed shell script must have the same style as other shell scripts on the server.
|
||||
|
||||
These files are examples:
|
||||
/home/lwc/bin/create_pod_langflow.sh
|
||||
/home/krt/bin/create_pod_qdrant.sh
|
||||
|
||||
## Your tasks
|
||||
|
||||
### Ask first
|
||||
|
||||
Before starting to design the shell script, ask between two and five questions to fully understand the situation, your tasks and the objectives.
|
||||
|
||||
### Identify the container image
|
||||
|
||||
Find the container image with Pinned Tag pointing to AFFiNE version 0.26.3.
|
||||
|
||||
### Write the shell script
|
||||
|
||||
Write the shell script.
|
||||
|
||||
### Test the shell script
|
||||
|
||||
Run the shell script and test it.
|
||||
|
||||
### Redesign if necessary
|
||||
|
||||
If the test failed, understand the problem, improve the shell script and go back to Test the shell script.
|
||||
|
||||
Repeat this in a loop up to five times.
|
||||
|
||||
## Your objectives
|
||||
|
||||
Your objectives are:
|
||||
- All requirements are fulfilled.
|
||||
- AFFiNE web user interface shows up at 127.0.0.1:8092.
|
||||
- The AFFiNE GraphQL API shows up under 127.0.0.1:8092 at /graphql or another link.
|
||||
|
||||
## Your behaviour
|
||||
|
||||
If it is not possible to achieve your objectives, interrupt and ask me.
|
||||
|
||||
Complete all your tasks without asking in between if you can achieve your objectives.
|
||||
|
||||
---
|
||||
|
||||
# New Traefik route
|
||||
|
||||
## Motivation
|
||||
|
||||
A new service runs on the server and needs to be provided to the internet by installing a new Traefik route.
|
||||
|
||||
## Traefik service
|
||||
|
||||
Traefik runs as a systemd service in a Podman Pod.
|
||||
To end the service and Pod, run `/home/trf/bin/remove_pod_systemd_services.sh`.
|
||||
To start the Pod and the service, run `create_pod_traefik.sh`.
|
||||
|
||||
## Traefik configuration
|
||||
|
||||
The Traefik configuration directory is `/home/trf/.local/share/traefik/`.
|
||||
|
||||
The main configuration file is `/home/trf/.local/share/traefik/traefik.yml`.
|
||||
In the directory `/home/trf/.local/share/traefik/dynamic` are the .yml files for the individual routings.
|
||||
|
||||
## New service
|
||||
|
||||
The new service for which the new Traefik route is needed:
|
||||
- Name is "affine"
|
||||
- Provided at 127.0.0.1:8092
|
||||
|
||||
## Your tasks
|
||||
|
||||
Your tasks are:
|
||||
- Ask questions if necessary to understand the situation and the tasks below.
|
||||
- Create the necessary file in `/home/trf/.local/share/traefik/dynamic`.
|
||||
- Update `/home/trf/.local/share/traefik/traefik.yml`.
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user