Opengist - lekki, samohostowany serwis do wklejania i udostępniania fragmentów kodu z podświetlaniem składni i pełną historią wersji, open source alternatywa dla GitHub Gist.
Środowisko
| Runtime | Oficjalny obraz Docker ghcr.io/thomiceli/opengist, domyślnie własna baza SQLite w wolumenie danych (opcjonalnie współdzielony MySQL Saplo), nginx Boxa jako reverse proxy |
| Zalecany plan | Box S+ (Docker, jeden lekki kontener, min 512 MB RAM) |
Przykładowy saplo.yaml
Plik saplo.yaml w katalogu głównym repozytorium opisuje, jak Saplo ma zbudować i uruchomić aplikację. Wygeneruje go też komenda saplo init.
version: 1
name: my-snippets
stack: opengist
app_id: 1234
Pełny opis wszystkich pól znajdziesz na stronie Plik saplo.yaml.
Jak wdrożyć
Ten stack wdrożysz na trzy sposoby - wybierz wygodny dla siebie:
- Z panelu - tworzysz aplikację klikami, kod wgrywasz później przez CLI lub Git.
- Saplo CLI - z katalogu projektu:
saplo init, potemsaplo deploy. - Deploy z GitHub - podłączasz repo raz, każdy push wdraża się sam.
# Najszybsza droga - z katalogu projektu
$ npm install -g @saplo/cli
$ saplo login
$ saplo init
$ saplo deploy
Dobrze wiedzieć
- Stawiasz z panelu jednym kliknięciem - Saplo instaluje Docker CE, pobiera obraz i uruchamia kontener.
- Domyślnie własna baza SQLite w wolumenie aplikacji - zero dodatkowej infrastruktury, przy instalacji możesz zamiast tego wybrać współdzielony MySQL Saplo.
- Konto administratora zakłada silnik automatycznie przy instalacji - login i wygenerowane hasło znajdziesz w pliku OPENGIST-SETUP.txt w katalogu aplikacji.
- Każdy wklejony fragment kodu to osobne repozytorium Git z pełną historią zmian, nie tylko ostatni zapis.
- Dostęp tylko przez HTTPS - wbudowany serwer SSH jest wyłączony, klonowanie i push działają po adresie aplikacji, nie po kluczu SSH.
- Publiczną rejestrację możesz wyłączyć w panelu administratora Opengista (Ustawienia -> Disable signup).
- Kopia (automatyczna od Box L, ręcznie snapshotem na każdym planie) obejmuje cały wolumen aplikacji (baza danych, repozytoria gistów).
Gotowy na deploy?
Wybierz plan Box i postaw aplikację Opengist jeszcze dziś.