Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

preview-env

/preview-env

Uruchamia, obserwuje i usuwa środowiska podglądowe Matrix OS (VPS na PR, rewizje Cloud Run, sloty HMR) i pozwala odpytywać ich scentralizowane logi.

Repozytorium
matrix-os ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Uruchamia, obserwuje i usuwa środowiska podglądowe Matrix OS (VPS na PR, rewizje Cloud Run, sloty HMR) i pozwala odpytywać ich scentralizowane logi.

Oryginalny opis (EN)

Spin up, observe, and tear down Matrix OS preview environments — per-PR preview VPSes, platform Cloud Run preview revisions, HMR staging slots — and query their centralized logs. Use when a change needs to be seen running (shell/gateway/onboarding/CLI/macOS features), when asked to deploy a branch for testing, or when you need logs from any preview, staging, or fleet VPS.

Jak działa

  1. Pick the surface
  2. Staging slots (inner loop)
  3. Preview VPS (verify loop)
  4. Logs — one interface for everything
  5. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 70 linii, 433 słów
Podgląd SKILL.md
---
name: preview-env
description: Spin up, observe, and tear down Matrix OS preview environments — per-PR preview VPSes, platform Cloud Run preview revisions, HMR staging slots — and query their centralized logs. Use when a change needs to be seen running (shell/gateway/onboarding/CLI/macOS features), when asked to deploy a branch for testing, or when you need logs from any preview, staging, or fleet VPS.
---

# Preview Environments

Production Matrix OS is VPS-native + Cloud Run; previews mirror that. Full
reference: `docs/dev/preview-environments.md`. Spec: `specs/093-preview-environments/`.

## Pick the surface

| You changed | Use | How |
|---|---|---|
| Shell/gateway/kernel UI, fast iteration | **Staging slot** (HMR, seconds per change) | `./scripts/staging-slot.sh up <worktree>` |
| Shell/gateway/kernel, production-shaped verify; onboarding (needs virgin VPS) | **Preview VPS** | add the `preview-vps` label to the PR |
| Platform (packages/platform) | **Platform preview revision** | add the `preview-platform` label to the PR |
| Organization collaboration (pre-merge gate) | **Collaboration preview** | labels `preview-vps`, `preview-collaboration` and `preview-platform`, then the `connect_collaboration_preview` dispatch (docs, "Collaboration previews") |
| macOS app | CI artifact + any preview VPS via `app.matrix-os.com/vm/<handle>` | build artifact from `macos-086.yml` |
| CLI | npm dist-tag paired with a preview VPS profile | see docs |

## Staging slots (inner loop)

Run from the ops VPS, repo root or any checkout:

```bash
./scripts/staging-slot.sh up ~/matrix-os.worktrees/<branch>   # claims slot N
# -> https://staging-<N>.matrix-os.com (HMR: edits in the worktree hot-reload)
./scripts/staging-slot.sh status            # who owns what
./scripts/staging-slot.sh down <N>          # release when done — slots are shared!
```

4 slots max. Always `down` your slot when finished; `status --reap` frees slots
idle past TTL.

## Preview VPS (verify loop)

Label the PR `preview-vps`. CI builds bundle `v<YYYY.MM.DD>-pr<N>-<run>-<attempt>-<sha7>`,
registers it **without any channel** (it can never reach real users), provisions VPS `pr-<N>`,
deploys, and comments the URL. Closed PR ⇒ VPS deleted (daily reaper as backstop,
72h TTL). Manual run: `gh workflow run preview-vps.yml -f pr=<N>`.

The shared `pr-<N>` VPS cannot use personal Integrations or Custom MCP. To test a PR
against your own connected accounts, an internal member runs `matrix preview start <N>`
for an owner-only Private Preview (see `docs/dev/preview-environments.md`).

## Logs — one interface for everything

```bash
./scripts/preview-logs.sh --handle pr-123 [--unit matrix-gateway] [--grep ERROR] [--since 1h]
./scripts/preview-logs.sh --slot 2 --since 30m
./scripts/preview-logs.sh --selector '{env="preview"}' --grep "unhandled"
```

Runs against the central Loki (loopback on the ops VPS). Slot logs ship
automatically (promtail docker discovery). A preview/fleet VPS ships logs after
one-time enrollment:

```bash
PLATFORM_SECRET=... LOGS_INGEST_USER=fleet LOGS_INGEST_PASSWORD=... \
  ./scripts/enable-vps-logship.sh pr-123 preview
```

(`LOGS_INGEST_*` live in `~/matrix-os/.env` on the ops VPS.)

## Rules

- Never promote a preview bundle to a channel; never deploy channel-wide from a PR.
- Never point a preview at production secrets or the production platform service.
- Tear down what you spin up: `staging-slot.sh down`, close the PR, or delete the
  VPS via `DELETE /vps/<machineId>` — never directly in Hetzner.
- Browser-level inspection: drive the preview URL with Playwright/chrome-devtools
  MCP; passive browser-log forwarding is deferred (spec 093).

Wersje

RepozytoriumWynikLicencja
Ta strona · hamedmp/matrix-os100AGPL-3.0
ctxpipe-ai/ctxpipe100MIT

Migawka bazy z 13.11.2026 · wersja paczki 02cbf94d4145 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100algolia-multi-env-setup
    Projektuje izolowane środowiska deweloperskie, stagingowe, podglądowe i produkcyjne Algolia z jawnymi regułami promocji i ograniczonymi danymi wyszukiwania.
  • 100rainbow-env
    Tworzy i odświeża podglądowe środowiska Rainbow Machine dla PR w Lightdash, uruchamia polecenia i sprawdza zmianę.
  • 100matrix-onboarding
    Konfiguruje, uwierzytelnia i diagnozuje chmurowy komputer Matrix OS: logowanie Matrix CLI, provisioning VPS, uwierzytelnianie agentów kodujących i GitHub oraz odzyskiwanie dostępu.
  • 90infra-preview
    Tworzy, resetuje, czyści i audytuje podglądowe środowiska dla zmian, usuwając osierocone instancje.
  • 100environment-setup
    Konfiguruje środowiska development, staging i produkcyjne: zmienne środowiskowe, pliki .env, zarządzanie konfiguracją i ustawienia zależne od środowiska.
  • 100test-environments
    Projektuje strategię środowisk testowych od dev po produkcję: Docker Compose, wieloetapowe Dockerfile, dane seed, środowiska preview per pull request i atrapy zależności zewnętrznych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.