m/cup
1
0
Fork 0
mirror of https://github.com/sergi0g/cup.git synced 2025-11-17 09:33:38 -05:00
Code Wiki Activity

Update docs

Browse Source
This commit is contained in:
Sergio
2025-02-28 19:37:48 +02:00
parent e2cc245a50
commit fa2629bb4f
3 changed files with 68 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/src/content/docs/configuration/index.mdx
View File

@@ -8,7 +8,7 @@ import {
IconLockOpen, IconLockOpen,
IconKey, IconKey,
IconPlug, IconPlug,
IconServer IconServer,
} from "@tabler/icons-react"; } from "@tabler/icons-react";
# Configuration # Configuration
@@ -71,12 +71,21 @@ Here's a full example:
```json ```json
{ {
"authentication": { "$schema": "https://raw.githubusercontent.com/sergi0g/cup/v3/cup.schema.json",
"ghcr.io": "<YOUR_TOKEN_HERE>", "version": 3,
"registry-1.docker.io": "<YOUR_TOKEN_HERE>" "images": {
"exclude": ["ghcr.io/immich-app/immich-machine-learning"],
"extra": ["ghcr.io/sergi0g/cup:v3.0.0"]
}, },
"theme": "blue", "registries": {
"insecure_registries": ["localhost:5000", "my-insecure-registry.example.com"] "myregistry.com": {
"authentication": "<YOUR_TOKEN_HERE>"
}
},
"servers": {
"Raspberry Pi": "https://server.local:8000"
},
"theme": "blue"
} }
``` ```

61
docs/src/content/docs/usage/cli.mdx
View File

@@ -12,36 +12,52 @@ Cup's CLI provides the `cup check` command.
```ansi ```ansi
$ cup check $ cup check
 ✓ Done!
mysql:8.0 Major update ~ Local images
node:20 Major update ╭─────────────────────────────────────────┬──────────────────────────────────┬─────────╮
postgres:16-alpine Major update │Reference │Status │Time (ms)│
rust:1.80.1-alpine Minor update ├─────────────────────────────────────────┼──────────────────────────────────┼─────────┤
redis:7.4.0 Patch update │postgres:15-alpine │Major update (15 → 17) │788 │
nginx:alpine Update available │ghcr.io/immich-app/immich-server:v1.118.2│Minor update (1.118.2 → 1.127.0) │2294 │
redis:alpine Update available │ollama/ollama:0.4.1 │Minor update (0.4.1 → 0.5.12) │533 │
ubuntu:latest Update available │adguard/adguardhome:v0.107.52 │Patch update (0.107.52 → 0.107.57)│1738 │
node:iron Up to date │jc21/nginx-proxy-manager:latest │Up to date │583 │
2fauth/2fauth:latest Up to date │louislam/uptime-kuma:1 │Up to date │793 │
c1982/sdns:latest Up to date │moby/buildkit:buildx-stable-1 │Up to date │600 │
registry.acme.com/acme-server:latest Unknown │tecnativa/docker-socket-proxy:latest │Up to date │564 │
INFO ✨ Checked 58 images in 3772ms │ubuntu:latest │Up to date │585 │
│wagoodman/dive:latest │Up to date │585 │
│rolebot:latest │Unknown │174 │
╰─────────────────────────────────────────┴──────────────────────────────────┴─────────╯
 INFO ✨ Checked 11 images in 8312ms
``` ```
### Check for updates to specific images ### Check for updates to specific images
```ansi ```ansi
$ cup check node:latest $ cup check node:latest
node:latest Update available ✓ Done!
INFO ✨ Checked 1 images in 1310ms ~ Local images
╭───────────┬────────────────┬─────────╮
│Reference │Status │Time (ms)│
├───────────┼────────────────┼─────────┤
│node:latest│Update available│788 │
╰───────────┴────────────────┴─────────╯
 INFO ✨ Checked 1 images in 310ms
``` ```
```ansi ```ansi
$ cup check nextcloud:30 postgres:14 mysql:8.0 $ cup check nextcloud:30 postgres:14 mysql:8.0
nextcloud:30 Update available ✓ Done!
postgres:14 Update available ~ Local images
mysql:8.0 Up to date ╭────────────┬────────────────────────┬─────────╮
INFO ✨ Checked 3 images in 1769ms │Reference │Status │Time (ms)│
├────────────┼────────────────────────┼─────────┤
│postgres:14 │Major update (14 → 17) │195 │
│mysql:8.0 │Major update (8.0 → 9.2)│382 │
│nextcloud:30│Up to date │585 │
╰────────────┴────────────────────────┴─────────╯
 INFO ✨ Checked 3 images in 769ms
``` ```
## Enable icons ## Enable icons
@@ -62,7 +78,8 @@ $ cup check -r
``` ```
<Callout emoji="⚠️"> <Callout emoji="⚠️">
When parsing Cup's output, capture only `stdout`, otherwise you might not get valid JSON (if there are warnings) When parsing Cup's output, capture only `stdout`, otherwise you might not get
valid JSON (if there are warnings)
</Callout> </Callout>
## Usage with Docker ## Usage with Docker

28
docs/src/content/docs/usage/server.mdx
View File

@@ -8,13 +8,13 @@ The server provides the `cup serve` command.
```ansi ```ansi
$ cup serve $ cup serve
INFO Starting server, please wait...  INFO Starting server, please wait...
INFO ✨ Checked 8 images in 8862ms  INFO ✨ Checked 8 images in 8862ms
INFO Ready to start!  INFO Ready to start!
HTTP GET / 200 in 0ms  HTTP GET / 200 in 0ms
HTTP GET /assets/index.js 200 in 3ms  HTTP GET /assets/index.js 200 in 3ms
HTTP GET /assets/index.css 200 in 0ms  HTTP GET /assets/index.css 200 in 0ms
HTTP GET /api/v3/json 200 in 0ms  HTTP GET /api/v3/json 200 in 0ms
``` ```
This will launch the server on port `8000`. To access it, visit `http://<YOUR_IP>:8000` (replace `<YOUR_IP>` with the IP address of the machine running Cup.) This will launch the server on port `8000`. To access it, visit `http://<YOUR_IP>:8000` (replace `<YOUR_IP>` with the IP address of the machine running Cup.)
@@ -29,13 +29,13 @@ Pass the `-p` argument with the port you want to use
```ansi ```ansi
$ cup serve -p 9000 $ cup serve -p 9000
INFO Starting server, please wait...  INFO Starting server, please wait...
INFO ✨ Checked 8 images in 8862ms  INFO ✨ Checked 8 images in 8862ms
INFO Ready to start!  INFO Ready to start!
HTTP GET / 200 in 0ms  HTTP GET / 200 in 0ms
HTTP GET /assets/index.js 200 in 3ms  HTTP GET /assets/index.js 200 in 3ms
HTTP GET /assets/index.css 200 in 0ms  HTTP GET /assets/index.css 200 in 0ms
HTTP GET /api/v3/json 200 in 0ms  HTTP GET /api/v3/json 200 in 0ms
``` ```
## Usage with Docker ## Usage with Docker