# Gogs (odamus)

Koodihoidla server (Gogs), kus hoitakse git reposid.

## Põhiinfo

| Omadus | Väärtus |
|---|---|
| Host | `gogs.odamus.com` |
| DNS | `188.166.84.16` ([[Tehniline/Serverid/edge|edge]]) |
| Päris asukoht | prod server `100.91.118.16` (Tailscale), edge_caddy pöörab sellele |
| Web | HTTP/HTTPS (pordid 80/443) |

## Ühendusmustrid

- **HTTPS koos tunnustega URL-is** — peamine meetod, sama muster kui docker-compose repo:
  `https://ardo:<parool>@gogs.odamus.com/<kasutaja>/<repo>.git`
  - parool on `.git/config` failis, mitte märkmetes
- **SSH** — git kasutab HTTPS-i, SSH git-serverina ei ole kasutusel.

## Repod

| Repo | URL | Haru | Märkused |
|---|---|---|---|
| `ardo/Obsidian` | `https://gogs.odamus.com/ardo/Obsidian.git` | `master` | Obsidian vault'i versiooniajalugu, lugejale avalik (push ainult tunnustega) |
| `docker/ohmu` | `https://gogs.odamus.com/docker/ohmu.git` | `master` | ohmu docker-compose konfiguratsioon, lokaalne töökoopia `/opt/docker-compose` |

## Uue repo loomine

Gogs ei loo repo'sid push'iga automaatselt — tuleb luua API või web UI kaudu. Cron varundus kasutab **parooli `.git/config`-is** (ei vaja token'it); token on vajalik ainult repo loomiseks API'ga.

1. **Genereeri API token**: Gogs → Settings → Applications → Generate New Token
   - Token anna tööriistale sel hetkel; peale kasutamist revoke'i (Settings → Applications → Delete)
   - Token'i märkmetesse **ei kirjutata** ega jäeta aeguvalt kehtima
2. **Loo privaatne repo** API kaudu:
   ```
   curl -H "Authorization: token <TOKEN>" -X POST https://gogs.odamus.com/api/v1/user/repos \
     -H "Content-Type: application/json" -d '{"name":"<nimi>","private":true}'
   ```
   (API parooli baasautentiga ei aktsepteeri — ainult token.)
3. **Seo remote ja pushi**:
   ```
   git init -b master
   git remote add origin https://ardo:<parool>@gogs.odamus.com/ardo/<nimi>.git
   git push -u origin master
   ```

## Seotud

- Obsidian varundus: [[Tehniline/Sünkroniseerimine]]
- Pöördeproxy: [[Tehniline/Serverid/edge]]
- Prod server (`100.91.118.16`, Tailscale) — gogs-i tegelik asukoht
- Serveri masin: [[Tehniline/Serverid/ohmu]]