Halaman ini adalah terjemahan dari versi bahasa Inggris. Label antarmuka dan nama menu ditulis dalam bahasa Inggris. Jika ada perbedaan, versi bahasa Inggris yang berlaku.

Instalasi di Liferay PaaS

Di Liferay PaaS, Anda menambahkan tiga proyek forum ke repositori proyek PaaS Anda, lalu men-deploy-nya bersama bagian proyek lainnya. Masing-masing berjalan sebagai layanan PaaS tersendiri: batch dan situs forum sebagai job, dan microservice sebagai layanan yang terus berjalan.

Langkah-langkah ini telah diuji pada Liferay DXP 2026.Q1.4 LTS yang bersih dengan perbaikan yang diperlukan, di salinan lokal dari cara Liferay PaaS menjalankan client extension, tetapi belum di lingkungan Liferay PaaS. Client extension adalah fitur beta di Liferay PaaS.

Langkah 1: Siapkan Proyek
Langkah 2: Instal Perbaikan Liferay
Langkah 3: Tambahkan Proyek-Proyek Forum
Langkah 4: Deploy Build Pertama
Langkah 5: Deploy Build Kedua
Langkah 6: Restart Microservice
Langkah 7: Siapkan Notifikasi Email
Langkah 8: Periksa Instalasi
Menambahkan Situs Forum Lain
Deploy Berikutnya
Informasi Terkait

Langkah 1: Siapkan Proyek

Ikuti panduan Liferay Configuring Liferay PaaS for Client Extensions. Khususnya:

Jika lingkungan infra Anda tidak memiliki pipeline build client extension, minta Liferay Cloud Support untuk mengaktifkannya.
Jika suatu lingkungan menggunakan autentikasi dasar (basic authentication) di web server-nya, izinkan path /o lewat tanpa autentikasi tersebut. Liferay dan microservice saling memanggil di bawah /o.
Hapus virtual.hosts.valid.hosts dan web.server.protocol dari pengaturan layanan Liferay, jika diatur. Client extension tidak berfungsi dengan pengaturan tersebut.

Langkah 2: Instal Perbaikan Liferay

Instal hotfix dengan perbaikan Liferay yang diperlukan sebelum Anda menambahkan proyek-proyek forum.

Tambahkan hotfix ke proyek Anda dengan salah satu cara berikut:
- Untuk setiap lingkungan: di ci/LCP.json, atur variabel lingkungan LCP_CI_LIFERAY_DXP_HOTFIXES_COMMON ke nama hotfix tanpa .zip:
```
  "env": {
    "LCP_CI_LIFERAY_DXP_HOTFIXES_COMMON": "<hotfix-name>"
  }
```
- Untuk satu lingkungan: gunakan LCP_CI_LIFERAY_DXP_HOTFIXES_<ENVIRONMENT> sebagai gantinya, misalnya LCP_CI_LIFERAY_DXP_HOTFIXES_PRD.
- Di repositori: letakkan zip hotfix di liferay/configs/<environment>/patching/, misalnya liferay/configs/prd/patching/, satu kali untuk setiap lingkungan.
Push perubahan tersebut, lalu deploy build-nya ke lingkungan Anda, seperti pada Langkah 4.
Setelah layanan Liferay di-restart, pastikan log-nya menampilkan The following patches are installed: dengan hotfix tersebut.

Lihat panduan Liferay Deploying to the Liferay Service untuk informasi lebih lanjut tentang menginstal hotfix.

Langkah 3: Tambahkan Proyek-Proyek Forum

Dari rilis terbaru, unduh kode sumber forum, liferay-forums-<version>-source.zip, lalu ekstrak. Hasil ekstraksinya adalah folder bernama liferay-forums-<version>, seperti liferay-forums-1.0.0.
Salin tiga folder berikut ke liferay/client-extensions di repositori proyek PaaS Anda:
- client-extensions/liferay-forums-batch
- client-extensions/liferay-forums-etc-spring-boot
- client-extensions/liferay-forums-site-initializer

Langkah 4: Deploy Build Pertama

Push proyek tersebut. Liferay Cloud akan membangunnya; build client extension adalah build Custom Services.
Di konsol Liferay Cloud, buka Builds, lalu pada build tersebut, pilih Deploy Build to…, lalu lingkungan Anda.

Setelah deploy selesai, job-job telah membuat data forum dan situs forum di /web/forums, dan microservice telah dimulai. Pastikan bahwa:

Log layanan Liferay menampilkan lima baris yang berisi Finished batch engine import task, satu untuk setiap file batch.
Control Panel → Objects menampilkan folder C2M0 Forums, dengan tujuh object: C2M0 Attachment, C2M0 Message, C2M0 Subscription, C2M0 Suspicious Activity, C2M0 Thread, C2M0 User, dan C2M0 Vote.
Control Panel → Security → OAuth 2 Administration menampilkan empat aplikasi forum: masing-masing satu untuk batch dan site initializer, serta dua untuk microservice, Liferay Forums Etc Spring Boot OAuth Application Headless Server dan User Agent.

Pada tahap ini, setiap balasan ditolak dengan pesan Your account has been banned from participating in the forums. Hal ini memang diharapkan: Liferay mendaftarkan microservice sebelum data forum ada, sehingga microservice belum memiliki akses ke data tersebut. Dua langkah berikutnya memperbaikinya.

Langkah 5: Deploy Build Kedua

Job-job forum berjalan lagi pada setiap deploy, padahal seharusnya tidak, karena data dan situs forum kini sudah ada:

Mulai dari deploy kedua, job batch akan melaporkan item yang gagal untuk dua template email forum, karena template tersebut sudah ada.
Setiap kali job site initializer berjalan lagi, alamat situs forum direset ke /web/group-<number>, yang merusak tautan forum. LPD-85594 tidak mencegah hal ini di Liferay PaaS.

Oleh karena itu, build kedua tidak menyertakan file template email dan site initializer:

Hapus file dan folder berikut dari repositori Anda:

 liferay/client-extensions/liferay-forums-batch/batch/05-notification-email-template.batch-engine-data.json
 liferay/client-extensions/liferay-forums-site-initializer

Push, lalu deploy build baru tersebut ke lingkungan Anda, seperti pada Langkah 4.

Liferay mendaftarkan microservice lagi, kali ini dengan akses ke data forum, dan memberikan kredensial baru kepadanya. Job batch berhasil, pada deploy ini dan setiap deploy berikutnya, dan template email, beserta perubahan yang Anda buat padanya, tetap seperti apa adanya. Situs forum tetap berada di /web/forums, dengan halaman dan kontennya: menghapus site initializer tidak menghapus situsnya.

Langkah 6: Restart Microservice

Di konsol Liferay Cloud, restart layanan liferayforumsetcspringboot, agar layanan tersebut menggunakan kredensial baru. Balasan kini diterima.

Jika balasan masih ditolak setelah restart, Liferay mungkin tidak dapat menjangkau microservice di localhost:58081. Di liferay/client-extensions/liferay-forums-etc-spring-boot/client-extension.yaml, ubah kedua baris .serviceAddress: localhost:58081 menjadi liferayforumsetcspringboot:58081, yaitu alamat layanan microservice, lalu deploy lagi. Hal ini belum diverifikasi di Liferay PaaS.

Langkah 7: Siapkan Notifikasi Email

Batch membuat dua template email dengan alamat pengirim placeholder. Atur alamat yang sebenarnya, lalu restart layanan liferayforumsetcspringboot, sebelum anggota menerima email. Lihat Notifikasi Email.

Langkah 8: Periksa Instalasi

Lanjutkan dengan Memeriksa Instalasi, untuk situs forum di /web/forums.

Menambahkan Situs Forum Lain

Setiap situs forum mendapatkan proyek site initializer tersendiri di repositori Anda, yang di-deploy satu kali, lalu dihapus lagi, seperti pada situs pertama. Lihat Beberapa Situs.

Deploy Berikutnya

Liferay memberikan kredensial baru kepada microservice pada setiap deploy proyek Anda, bahkan deploy yang tidak mengubah forum. Sampai microservice di-restart dengan kredensial tersebut, balasan ditolak dengan pesan Your account has been banned from participating in the forums. Setelah setiap deploy, restart layanan liferayforumsetcspringboot, seperti pada Langkah 6, dan pastikan balasan diterima.