Memasang di OpenShift¶

Dengan templat OpenShift Weblate, Anda dapat langsung menjalankan instansi Weblate pribadi Anda dalam hitungan detik. Semua dependensi Weblate sudah disertakan. PostgreSQL diatur sebagai basis data bawaan dan klaim volume persisten digunakan.

Anda dapat menemukan templatnya di <https://github.com/WeblateOrg/openshift/>.

Pemasangan¶

Contoh berikut mengasumsikan Anda memiliki lingkungan OpenShift v3.x yang berfungsi, dengan alat klien oc terpasang. Silakan periksa dokumentasi OpenShift untuk petunjuk lebih lanjut.

template.yml cocok untuk menjalankan semua komponen di OpenShift. Terdapat juga template-external-postgresql.yml yang tidak memulai server PostgreSQL dan mengizinkan Anda mengkonfigurasikan server PostgreSQL eksternal.

Konsol Web¶

Salin konten mentah dari template.yml dan impor ke proyek Anda, lalu gunakan tombol Buat di konsol web OpenShift untuk membuat aplikasi Anda. Konsol web akan meminta Anda memasukkan nilai untuk semua parameter yang digunakan oleh templat.

CLI¶

Untuk mengunggah templat Weblate ke pustaka templat proyek Anda saat ini, berikan berkas template.yml dengan perintah berikut:

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

Templat sekarang tersedia untuk dipilih menggunakan konsol web atau CLI.

Parameter¶

Parameter yang dapat Anda timpa tercantum di bagian parameter templat. Anda dapat mencantumkannya melalui CLI dengan menggunakan perintah berikut dan menentukan berkas yang akan digunakan:

$ 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

Penyediaan¶

Anda juga dapat menggunakan CLI untuk memproses templat dan menggunakan konfigurasi yang dihasilkan untuk segera membuat objek.

$ 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

Instansi Weblate seharusnya tersedia setelah migrasi dan penyebaran berhasil pada parameter WEBLATE_SITE_DOMAIN yang ditentukan.

Setelah pengaturan kontainer, Anda dapat masuk sebagai pengguna admin dengan kata sandi yang diberikan dalam WEBLATE_ADMIN_PASSWORD, atau kata sandi acak yang dibuat saat pertama kali memulai jika tidak diatur.

Untuk mengatur ulang kata sandi admin, mulai ulang kontainer dengan WEBLATE_ADMIN_PASSWORD yang diatur ke kata sandi baru dalam Secret masing-masing.

Hilangkan¶

$ 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

Konfigurasi¶

Dengan memproses templat, ConfigMap yang sesuai akan dibuat dan dapat digunakan untuk menyesuaikan gambar Weblate. ConfigMap dipasang langsung sebagai variabel lingkungan dan memicu penyebaran baru setiap kali diubah. Untuk opsi konfigurasi lebih lanjut, lihat Variabel lingkungan Docker untuk daftar lengkap variabel lingkungan.