Inštalácia na OpenShift¶

Pomocou šablóny OpenShift Weblate môžete mať svoju osobnú inštanciu Weblate spustenú za pár sekúnd. Všetky závislosti Weblate sú už zahrnuté. PostgreSQL je nastavený ako predvolená databáza a používajú sa trvalé nároky na zväzky.

Šablónu nájdete na <https://github.com/WeblateOrg/openshift/>.

Inštalácia¶

Nasledujúce príklady predpokladajú, že máte funkčné prostredie OpenShift v3.x s nainštalovaným klientskym nástrojom oc. Prosím, skontrolujte dokumentáciu OpenShift pre inštrukcie.

template.yml je vhodný na spúšťanie všetkých komponentov v OpenShift. Existuje aj template-external-postgresql.yml, ktorý nespúšťa server PostgreSQL a umožňuje vám nakonfigurovať externý server PostgreSQL.

Webová konzola¶

Skopírujte surový obsah z template.yml a importujte ho do vášho projektu, potom použite tlačidlo Vytvoriť vo webovej konzole OpenShift na vytvorenie vašej aplikácie. Webová konzola vás vyzve na zadanie hodnôt pre všetky parametre používané šablónou.

CLI¶

Na nahratie šablóny Weblate do knižnice šablón vášho aktuálneho projektu odovzdajte súbor template.yml pomocou nasledujúceho príkazu:

$ oc create -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
   -n <PROJECT>

Šablóna je teraz dostupná na výber pomocou webovej konzoly alebo CLI.

Parametre¶

Parametre, ktoré môžete prepísať, sú uvedené v sekcii parametrov šablóny. Môžete ich vypísať pomocou CLI použitím nasledujúceho príkazu a špecifikovaním súboru, ktorý sa má použiť:

$ oc process --parameters -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml

# If the template is already uploaded
$ oc process --parameters -n <PROJECT> weblate

Zriaďovanie¶

Môžete tiež použiť CLI na spracovanie šablón a použiť vygenerovanú konfiguráciu na okamžité vytvorenie objektov.

$ oc process -f https://raw.githubusercontent.com/WeblateOrg/openshift/main/template.yml \
    -p APPLICATION_NAME=weblate \
    -p WEBLATE_VERSION=4.3.1-1 \
    -p WEBLATE_SITE_DOMAIN=weblate.app-openshift.example.com \
    -p POSTGRESQL_IMAGE=docker-registry.default.svc:5000/openshift/postgresql:9.6 \
    -p REDIS_IMAGE=docker-registry.default.svc:5000/openshift/redis:3.2 \
    | oc create -f

Inštancia Weblate by mala byť dostupná po úspešnej migrácii a nasadení na špecifikovanom parametri WEBLATE_SITE_DOMAIN.

Po nastavení kontajnera sa môžete prihlásiť ako používateľ admin s heslom poskytnutým v WEBLATE_ADMIN_PASSWORD, alebo s náhodným heslom vygenerovaným pri prvom štarte, ak nebolo nastavené.

Na resetovanie hesla admin reštartujte kontajner s WEBLATE_ADMIN_PASSWORD nastaveným na nové heslo v príslušnom Secret.

Odstrániť¶

$ oc delete all -l app=<APPLICATION_NAME>
$ oc delete configmap -l app= <APPLICATION_NAME>
$ oc delete secret -l app=<APPLICATION_NAME>
# ATTENTION! The following command is only optional and will permanently delete all of your data.
$ oc delete pvc -l app=<APPLICATION_NAME>

$ oc delete all -l app=weblate \
    && oc delete secret -l app=weblate \
    && oc delete configmap -l app=weblate \
    && oc delete pvc -l app=weblate

Konfigurácia¶

Spracovaním tejto šablóny sa vytvorí príslušný ConfigMap, ktorý možno použiť na prispôsobenie Weblate image. ConfigMap sa priamo pripojí ako premenné prostredia a pri každej zmene vyvolá nové nasadenie. Ďalšie možnosti konfigurácie nájdeš v Premenné prostredia pre Docker, kde je uvedený úplný zoznam premenných prostredia.