Liferay Community APAC
Liferay Forums dokumentasi

Beranda/Marketplace Apps/Liferay Forums/Instalasi

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.

Pengembangan dengan Liferay Workspace

Jika Anda membangun kode Liferay Anda sendiri dengan Liferay Workspace, Anda dapat menambahkan proyek-proyek forum ke dalamnya, membangunnya bersama kode Anda, dan men-deploy-nya ke bundle Liferay milik workspace itu sendiri untuk pengembangan.

Ini bukan cara terpisah untuk menginstal forum. Untuk menginstalnya di server, di Docker, atau di Liferay SaaS, bangun zip-zip di sini, lalu ikuti Instalasi dengan zip tersebut. Folder liferay dari proyek Liferay PaaS sudah merupakan workspace: ikuti Di Liferay PaaS.

Diuji dengan plugin Gradle Liferay Workspace 15.0.0 dan Liferay DXP 2026.Q1.4. Anda memerlukan Blade, atau jalankan ./gradlew milik workspace sebagai pengganti blade gw.

  1. Langkah 1: Tambahkan Proyek-Proyek Forum
  2. Langkah 2: Bangun Proyek-Proyek Tersebut
  3. Langkah 3: Deploy ke Bundle Workspace
  4. Langkah 4: Periksa Instalasi
  5. Hal yang Harus Dihindari
  6. Informasi Terkait

Langkah 1: Tambahkan Proyek-Proyek Forum

  1. 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.

  2. Salin tiga folder berikut ke folder client-extensions di workspace Anda:

    • client-extensions/liferay-forums-batch
    • client-extensions/liferay-forums-etc-spring-boot
    • client-extensions/liferay-forums-site-initializer

Workspace mengenalinya sebagai proyek client extension, di samping proyek Anda sendiri, tanpa perubahan lain.

Langkah 2: Bangun Proyek-Proyek Tersebut

Dari folder root workspace:

blade gw build

Setiap zip ditulis ke folder dist proyeknya, misalnya client-extensions/liferay-forums-batch/dist/liferay-forums-batch.zip. Zip-zip ini sama dengan zip dalam rilis.

Langkah 3: Deploy ke Bundle Workspace

Langkah ini untuk bundle Liferay milik workspace, yang disiapkan dengan blade server init. Mulai bundle tersebut, dan tunggu hingga selesai dimulai. Task deploy setiap proyek hanya menyalin zip miliknya sendiri ke bundle, secara default di bundles/osgi/client-extensions.

Jangan pernah menginstal dengan blade gw deploy. Deploy untuk seluruh workspace men-deploy semua proyek sekaligus, sehingga zip microservice dapat tiba sebelum batch selesai, dan setiap postingan kemudian ditolak.

Jika Anda meletakkan proyek-proyek tersebut di subfolder, seperti client-extensions/forums, path task mengikutinya: :client-extensions:forums:liferay-forums-batch:deploy.

  1. Batch. Lalu tunggu hingga log Liferay menampilkan lima baris yang berisi Finished batch engine import task:

     blade gw :client-extensions:liferay-forums-batch:deploy

  2. Zip microservice:

     blade gw :client-extensions:liferay-forums-etc-spring-boot:deploy

  3. Mulai microservice, seperti pada Langkah 4 dari Liferay Self-Hosted (Tomcat): ekstrak client-extensions/liferay-forums-etc-spring-boot/dist/liferay-forums-etc-spring-boot.zip ke sebuah folder, lalu mulai dengan LIFERAY_HOME diatur ke path lengkap bundle. Gunakan path lengkap: start.sh berjalan dari foldernya sendiri.

     LIFERAY_HOME=/home/me/my-workspace/bundles ./start.sh

  4. Siapkan notifikasi email, seperti dalam Notifikasi Email, lalu restart microservice.

  5. Situs forum. Setelah situs ada, hapus liferay-forums-site-initializer.zip dari bundles/osgi/client-extensions.

     blade gw :client-extensions:liferay-forums-site-initializer:deploy

Untuk situs forum lainnya, tambahkan salinan proyek site initializer per situs, seperti dalam Beberapa Situs, lalu deploy masing-masing dengan task deploy-nya sendiri.

Langkah 4: Periksa Instalasi

Lanjutkan dengan Memeriksa Instalasi.

Hal yang Harus Dihindari

  • Deploy untuk seluruh workspace di kemudian hari melewati proyek yang tidak berubah, sehingga blade gw deploy untuk kode Anda sendiri tidak men-deploy forum lagi. Setelah blade gw clean, atau perubahan pada proyek forum, perintah tersebut men-deploy zip forum lagi, semuanya sekaligus. Kemudian restart microservice, yang mendapatkan kredensial baru, dan lihat Men-deploy Batch Lagi.
  • Task Docker milik workspace, seperti buildDockerImage dan startDockerContainer, memasukkan setiap proyek ke dalam image Liferay, dan Liferay men-deploy-nya saat dimulai, yang terlalu awal bagi microservice dan site initializer. Untuk Docker, bangun zip-zip di sini, lalu ikuti Liferay Self-Hosted (Docker).