Compare commits

..

No commits in common. "6ad46e7452d0bd5926fcbe96d79a54adad974187" and "a4dfbdcd5225429ed64689f281ca6a3601bfaa08" have entirely different histories.

8 changed files with 154 additions and 68 deletions

View file

@ -29,7 +29,7 @@ jobs:
run: nix build .#nixosConfigurations.cryodev-pi.config.system.build.toplevel --impure run: nix build .#nixosConfigurations.cryodev-pi.config.system.build.toplevel --impure
build-pi-images: build-pi-images:
needs: build-hosts needs: flake-check
runs-on: host runs-on: host
strategy: strategy:
matrix: matrix:

View file

@ -27,7 +27,7 @@ nix build .#nixosConfigurations.cryodev-pi.config.system.build.sdImage
# Format code (required before committing) # Format code (required before committing)
nix fmt nix fmt
# Run all checks (lint, formatting) # Run all checks (lint, formatting, deploy-rs validation)
nix flake check nix flake check
# Quick evaluation test (faster than full build) # Quick evaluation test (faster than full build)
@ -46,17 +46,14 @@ nix develop
# Deploy all hosts via deploy app (uses deploy.json) # Deploy all hosts via deploy app (uses deploy.json)
nix run .#deploy nix run .#deploy
# Deploy a specific host # Deploy to cryodev-main via deploy-rs
nix run .#deploy -- -n cryodev-main nix run github:serokell/deploy-rs -- .#cryodev-main
# Manual deployment via SSH # Manual deployment via SSH
NIX_SSHOPTS="-p 2299" nixos-rebuild switch --flake .#<hostname> \ NIX_SSHOPTS="-p 2299" nixos-rebuild switch --flake .#<hostname> \
--target-host <user>@<ip> --sudo --ask-sudo-password --target-host <user>@<ip> --sudo --ask-sudo-password
``` ```
> **Note:** Both hosts use Comin for automatic pull-based deployment.
> Manual deployment is only needed for the initial setup or emergencies.
### Apps ### Apps
```bash ```bash
@ -203,7 +200,7 @@ services.nginx.enable = lib.mkDefault true;
| Host | Strategy | Trigger | | Host | Strategy | Trigger |
|------|----------|---------| |------|----------|---------|
| `cryodev-main` | Pull via Comin | Automatic polling | | `cryodev-main` | Push via deploy-rs | Forgejo Actions on push to main |
| `cryodev-pi` | Pull via Comin | Automatic polling | | `cryodev-pi` | Pull via Comin | Automatic polling |
| SD Images | Built in CI | Push to main (for Pi hosts) | | SD Images | Built in CI | Push to main (for Pi hosts) |

View file

@ -6,8 +6,8 @@ Declarative NixOS infrastructure for the **cryodev** environment, managed with N
```bash ```bash
# Clone repository # Clone repository
git clone https://git.cryodev.xyz/steffen/cryodev.git git clone https://git.cryodev.xyz/steffen/cryodev-server.git
cd cryodev cd cryodev-server
# Check configuration # Check configuration
nix flake check nix flake check
@ -20,7 +20,7 @@ nix build .#nixosConfigurations.cryodev-main.config.system.build.toplevel
| Host | Architecture | Deployment | Description | | Host | Architecture | Deployment | Description |
|------|--------------|------------|-------------| |------|--------------|------------|-------------|
| `cryodev-main` | x86_64 | Pull (Comin) | Main server | | `cryodev-main` | x86_64 | Push (deploy-rs) | Main server |
| `cryodev-pi` | aarch64 | Pull (Comin) | Raspberry Pi client | | `cryodev-pi` | aarch64 | Pull (Comin) | Raspberry Pi client |
## Services ## Services
@ -37,7 +37,7 @@ nix build .#nixosConfigurations.cryodev-main.config.system.build.toplevel
SD card images for Raspberry Pi clients are **built automatically** on every push to `main`. SD card images for Raspberry Pi clients are **built automatically** on every push to `main`.
Download from: [Releases](https://git.cryodev.xyz/steffen/cryodev/releases) Download from: [Releases](https://git.cryodev.xyz/steffen/cryodev-server/releases)
```bash ```bash
# Flash to SD card # Flash to SD card

View file

@ -1,38 +1,121 @@
# Continuous Deployment # Continuous Deployment
All hosts use **Comin** (pull-based) for automatic deployment. The cryodev infrastructure uses two deployment strategies optimized for different host types.
## Overview ## Overview
| Host | Strategy | Tool | Trigger | | Host | Strategy | Tool | Trigger |
|------|----------|------|---------| |------|----------|------|---------|
| `cryodev-main` | Pull-based | Comin | Automatic polling | | `cryodev-main` | Push-based | deploy-rs | Git push via Forgejo Actions |
| `cryodev-pi` | Pull-based | Comin | Automatic polling | | `cryodev-pi` | Pull-based | Comin | Periodic polling |
## How It Works ## Push-based Deployment (cryodev-main)
### How It Works
1. Developer pushes to `main` branch 1. Developer pushes to `main` branch
2. CI (Forgejo Actions) runs flake-check and builds all hosts 2. Forgejo Actions workflow triggers
3. Comin on each host periodically polls the Git repository 3. `deploy-rs` connects via SSH and deploys
4. On changes, Comin builds and activates the new configuration
## Configuration ### Setup
#### 1. Generate Deploy Key
```bash
ssh-keygen -t ed25519 -f deploy_key -C "forgejo-actions"
```
#### 2. Add Public Key to Server
On `cryodev-main`:
```bash
echo "PUBLIC_KEY_CONTENT" >> /root/.ssh/authorized_keys
```
#### 3. Add Private Key to Forgejo
1. Go to Repository Settings > Secrets
2. Add secret named `DEPLOY_SSH_KEY`
3. Paste the private key content
#### 4. Workflow Configuration
`.forgejo/workflows/deploy.yaml`:
```yaml
name: Deploy
on:
push:
branches: [main]
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: cachix/install-nix-action@v24
- run: nix flake check
deploy:
needs: check
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: cachix/install-nix-action@v24
- name: Setup SSH
env:
SSH_PRIVATE_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
run: |
mkdir -p ~/.ssh
echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519
ssh-keyscan cryodev-main >> ~/.ssh/known_hosts
- name: Deploy
run: nix run github:serokell/deploy-rs -- .#cryodev-main
```
### Rollback
deploy-rs automatically rolls back if the new configuration fails health checks.
Manual rollback:
```bash
# List generations
sudo nix-env -p /nix/var/nix/profiles/system --list-generations
# Rollback to previous
sudo nixos-rebuild switch --rollback
```
## Pull-based Deployment (cryodev-pi)
### How It Works
1. Comin periodically polls the Git repository
2. On changes, it builds and activates the new configuration
3. Works through NAT without incoming connections
### Configuration
```nix ```nix
# hosts/<hostname>/services/comin.nix # hosts/cryodev-pi/services/comin.nix
{ {
services.comin = { services.comin = {
enable = true; enable = true;
remotes = [{ remotes = [{
name = "origin"; name = "origin";
url = "https://git.cryodev.xyz/steffen/cryodev.git"; url = "https://git.cryodev.xyz/steffen/cryodev-server.git";
branches.main.name = "main"; branches.main.name = "main";
}]; }];
}; };
} }
``` ```
## Monitoring ### Monitoring
Check Comin status: Check Comin status:
@ -47,7 +130,7 @@ Force immediate update:
sudo systemctl restart comin sudo systemctl restart comin
``` ```
## Troubleshooting ### Troubleshooting
If Comin fails to build: If Comin fails to build:
@ -57,30 +140,23 @@ sudo journalctl -u comin --since "1 hour ago"
# Manual build test # Manual build test
cd /var/lib/comin/repo cd /var/lib/comin/repo
nix build .#nixosConfigurations.<hostname>.config.system.build.toplevel nix build .#nixosConfigurations.cryodev-pi.config.system.build.toplevel
```
## Rollback
```bash
# List generations
sudo nix-env -p /nix/var/nix/profiles/system --list-generations
# Rollback to previous
sudo nixos-rebuild switch --rollback
``` ```
## Manual Deployment ## Manual Deployment
For initial setup or emergencies: For hosts not using automated deployment:
```bash ```bash
# Using the deploy app # Build locally
nix run .#deploy -- -n <hostname> nix build .#nixosConfigurations.<hostname>.config.system.build.toplevel
# Or manually with nixos-rebuild # Deploy with nixos-rebuild
NIX_SSHOPTS="-p 2299" nixos-rebuild switch --flake .#<hostname> \ NIX_SSHOPTS="-p 2299" nixos-rebuild switch --flake .#<hostname> \
--target-host <user>@<hostname> --sudo --ask-sudo-password --target-host <user>@<hostname> --sudo --ask-sudo-password
# Or using deploy-rs
nix run github:serokell/deploy-rs -- .#<hostname>
``` ```
## Testing Changes ## Testing Changes

View file

@ -90,5 +90,5 @@ Für Raspberry Pi: [SD-Image Referenz](getting-started/sd-image.md)
| Host | Strategie | Tool | Beschreibung | | Host | Strategie | Tool | Beschreibung |
|------|-----------|------|--------------| |------|-----------|------|--------------|
| `cryodev-main` | Pull-basiert | Comin | Pollt Repository auf Aenderungen | | `cryodev-main` | Push-basiert | deploy-rs via Forgejo Actions | Sofortige Updates bei Push |
| `cryodev-pi` | Pull-basiert | Comin | Pollt Repository auf Aenderungen | | `cryodev-pi` | Pull-basiert | Comin | Pollt Repository auf Änderungen |

View file

@ -75,23 +75,44 @@ forgejo-runner:
## CI/CD Workflows ## CI/CD Workflows
CI runs on every push to `main` via Forgejo Actions: ### deploy-rs Workflow
1. **flake-check** -- validates the flake `.forgejo/workflows/deploy.yaml`:
2. **build-hosts** -- builds all host configurations
Deployment is handled by **Comin** (pull-based), not by CI. ```yaml
See [CD documentation](../deployment/cd.md) for details. name: Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install Nix
uses: cachix/install-nix-action@v24
- name: Deploy
env:
SSH_PRIVATE_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
run: |
mkdir -p ~/.ssh
echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519
nix run .#deploy
```
## Administration ## Administration
### Create Admin User ### Create Admin User
```bash ```bash
forgejo admin user create \ sudo -u forgejo forgejo admin user create \
--username <benutzername> \ --username admin \
--email <email>@<domain> \ --password changeme \
--password <passwort> \ --email admin@cryodev.xyz \
--admin --admin
``` ```

View file

@ -3,15 +3,11 @@
{ {
boot = { boot = {
kernelPackages = pkgs.linuxKernel.packages.linux_rpi4; kernelPackages = pkgs.linuxKernel.packages.linux_rpi4;
initrd = { initrd.availableKernelModules = [
availableKernelModules = [
"xhci_pci" "xhci_pci"
"usbhid" "usbhid"
"usb_storage" "usb_storage"
]; ];
# Disable default x86 modules that don't exist in the Pi kernel (e.g. dw-hdmi)
includeDefaultModules = false;
};
}; };
fileSystems = { fileSystems = {

View file

@ -3,15 +3,11 @@
{ {
boot = { boot = {
kernelPackages = pkgs.linuxKernel.packages.linux_rpi4; kernelPackages = pkgs.linuxKernel.packages.linux_rpi4;
initrd = { initrd.availableKernelModules = [
availableKernelModules = [
"xhci_pci" "xhci_pci"
"usbhid" "usbhid"
"usb_storage" "usb_storage"
]; ];
# Disable default x86 modules that don't exist in the Pi kernel (e.g. dw-hdmi)
includeDefaultModules = false;
};
}; };
fileSystems = { fileSystems = {