Cara Memasang Lucee: Panduan Lengkap Ubuntu, Docker dan Windows

Cara Memasang Lucee: Panduan Lengkap Ubuntu, Docker dan Windows

Memasang Lucee sebenarnya mudah kerana projek ini menyediakan beberapa edaran pemasangan yang berbeza, dan semuanya boleh dimuat turun dari satu halaman sahaja iaitu download.lucee.org. Cara install Lucee yang paling cepat untuk mencuba ialah Lucee Express, fail ZIP yang terus berjalan dari folder tanpa sebarang pemasangan. Untuk persekitaran pengeluaran, pilih Lucee Installer (.exe untuk Windows, .run untuk Linux) atau imej Docker rasmi.

Lucee ialah enjin CFML sumber terbuka yang berjalan di atas Java Virtual Machine (JVM). Ini perkara penting yang perlu anda fahami dari awal: hampir semua kaedah pemasangan memerlukan Java Development Kit (JDK) tersedia pada mesin anda. Satu pengecualian ialah Lucee Installer, yang membawa JDK sendiri (AdoptOpenJDK) di dalam pemasangannya. Artikel ini ditulis untuk pembangun yang belum pernah memasang Lucee, jadi setiap langkah diterangkan satu persatu. Jika anda belum kenal Lucee atau CFML, baca dahulu apa itu Lucee dan CFML.

Lima Cara Memasang Lucee

Dokumentasi rasmi Lucee menyenaraikan lima kaedah utama, dan pilihan anda bergantung pada tujuan:

1. Lucee Express (fail ZIP) untuk mencuba dan pembangunan tempatan.
2. Docker untuk pembangunan dan pengeluaran yang konsisten.
3. Lucee Installer (.exe atau .run) untuk pengeluaran dengan pelayan web di hadapan.
4. CommandBox untuk pengurusan automatik dari baris arahan.
5. Pemasangan manual dengan fail lucee.jar atau lucee.war ke dalam enjin servlet seperti Tomcat.

Setiap kaedah dibincangkan di bawah. Tidak kira kaedah mana yang anda pilih, enjin Lucee yang anda peroleh ialah perisian yang sama.

Kaedah 1: Lucee Express (Paling Mudah)

Lucee Express ialah cara terpantas untuk melihat Lucee berjalan. Ia ialah fail ZIP yang mengandungi Lucee dan Tomcat dalam bentuk ringan, tanpa pemasangan JDK, tanpa perkhidmatan sistem dan tanpa penyambung (connector) pelayan web. Secara lalai ia mendengar pada port 8888.

Langkahnya:

1. Muat turun fail ZIP Lucee Express dari download.lucee.org.
2. Ekstrak fail ZIP ke dalam folder pilihan anda.
3. Pastikan JDK sudah dipasang pada sistem anda, kerana Lucee Express memerlukannya.
4. Jalankan skrip permulaan:

# Linux atau macOS
./bin/startup.sh

# Windows
bin\startup.bat

5. Buka pelayar dan pergi ke http://localhost:8888.

Jika anda mahu Lucee Express menggunakan JDK khas tanpa memasang JDK ke seluruh sistem, anda boleh menetapkan pemboleh ubah persekitaran JRE_HOME melalui fail setenv.sh (Linux atau macOS) atau setenv.bat (Windows) di dalam folder bin. Lucee Express sesuai untuk ujian dan pembangunan tempatan yang tidak memerlukan pelayan web di hadapan, tetapi ia tidak digalakkan untuk pengeluaran.

Kaedah 2: Pasang Lucee dengan Docker

Docker ialah cara moden dan bersih untuk menjalankan Lucee, terutamanya jika anda merancang untuk deploy ke pelayan pengeluaran. Imej rasmi Lucee dibina di atas Tomcat dan tersedia di Docker Hub.

docker pull lucee/lucee:latest
docker run -d -p 8888:8888 lucee/lucee:latest

Arahan kedua menjalankan bekas (container) secara latar belakang dan memetakan port 8888 bekas ke port 8888 hos. Untuk menyimpan kod aplikasi anda, gunakan Docker Compose dengan pemetaan kelantangan (volume):

services:
  lucee:
    image: lucee/lucee:latest
    ports:
      - "8888:8888"
    volumes:
      - ./www:/var/www
      - ./config/lucee:/opt/lucee/web

Folder ./www pada mesin anda dipetakan ke /var/www di dalam bekas, iaitu direktori webroot. Anda boleh menambah pelayan Nginx sebagai proksi terbalik di hadapan Lucee. Satu ciri penting imej Docker ialah pemboleh ubah persekitaran LUCEE_BUILD=true yang membolehkan anda memanaskan (prewarm) Lucee semasa proses bina imej. Fungsi onBuild dalam Server.cfc akan dijalankan pada fasa ini:

// /opt/lucee-server/context/context/Server.cfc
component {
    public function onBuild() {
        systemOutput("Building Lucee (Docker)", true);
    }
}

Mulai Lucee 6.2, anda juga boleh mengarahkan log ke konsol Docker dengan menetapkan LUCEE_LOGGING_FORCE_APPENDER=console. Satu nasihat prestasi daripada dokumentasi: elakkan menjadikan folder di bawah lucee-server sebagai kelantangan Docker kerana overhead sistem fail hos akan merosot prestasi. Panduan lanjut ada dalam artikel deploy Lucee dengan Docker.

Kaedah 3: Lucee Installer (Windows dan Ubuntu)

Lucee Installer ialah penyelesaian semua dalam satu yang disyorkan untuk pemasangan pengeluaran biasa. Ia memasang pelayan Lucee, Tomcat, JDK sendiri (AdoptOpenJDK), mod_cfml untuk konfigurasi berbilang laman web, dan penyambung Boncode untuk menyambungkan pelayan web ke Tomcat.

Pada Windows, jalankan fail .exe sebagai Administrator pada mesin yang IIS sudah berjalan, supaya pemasang dapat mengesan IIS dan menyambungkannya ke Lucee melalui penyambung Boncode AJP dan mod_cfml. Pada Ubuntu atau Linux lain, jalankan fail .run dengan sudo pada mesin yang Apache sudah berjalan, supaya pemasang dapat mengesan Apache dan menyambungkannya melalui ReverseProxy dan mod_cfml. Anda mungkin perlu memberikan keizinan laksana terlebih dahulu:

chmod +x lucee-installer.run
sudo ./lucee-installer.run

Pemasangan jenis ini sesuai apabila anda mahu pelayan web seperti Apache atau IIS bertindak di hadapan Lucee, dan Lucee berjalan sebagai perkhidmatan (service) sistem.

Kaedah 4: CommandBox

CommandBox ialah alat baris arahan daripada Ortus Solutions yang memudahkan pemasangan dan pengurusan Lucee. Buka terminal dari dalam webroot aplikasi anda, taip box server start, dan CommandBox akan memulakan contoh Lucee stabil terkini yang menjalankan aplikasi anda. CommandBox menggunakan enjin servletnya sendiri iaitu Undertow, yang boleh disesuaikan melalui satu fail konfigurasi JSON.

CommandBox juga ialah pengurus pakej. Anda boleh memasang alat CFML berguna seperti cfconfig, TestBox, CFLint dan CFFormat, atau memasang rangka kerja CFML popular dengan cara scaffolding yang moden. CommandBox sesuai untuk pembangunan tempatan dan juga pengeluaran.

Kaedah 5: Pemasangan Manual (lucee.jar atau lucee.war)

Jika anda mahu menjalankan Lucee di atas enjin servlet lain seperti Jetty, Undertow atau persekitaran awan seperti AWS Elastic Beanstalk, guna fail lucee.jar atau lucee.war. Fail lucee.jar ialah bekas servlet Lucee sebagai arkib Java (JAR), manakala lucee.war ialah arkib aplikasi web (WAR) yang mengandungi lucee.jar.

Satu perkara teknikal yang penting: Lucee 6.2 masih berasaskan javax tetapi turut menyokong Jakarta Servlet secara pilihan. Lucee 7.0 pula hanya menyokong Jakarta Servlet, seperti Tomcat 11 dan Jetty 12. Ini penting jika anda memilih enjin servlet sendiri. Fail lucee.jar juga boleh digunakan untuk menaik taraf pemasangan sedia ada dengan hanya menggantikan fail .jar di dalam folder perpustakaan enjin servlet, tetapi pastikan anda membuat sandaran terlebih dahulu.

Jadual Perbandingan Kaedah

Dengan jadual ini, anda boleh melihat dengan jelas kaedah mana yang paling sesuai untuk situasi anda.

Selepas Pemasangan: Kata Laluan Admin dan Datasource

Setelah Lucee berjalan, dua tugas seterusnya ialah:

1. Tetapkan kata laluan pentadbir. Lucee memerlukan kata laluan awal ditetapkan sebelum anda boleh membuka Lucee Administrator di /lucee/admin/web.cfm.
2. Konfigurasikan datasource supaya aplikasi anda boleh bercakap dengan pangkalan data. Baca panduan konfigurasi datasource.

Untuk mengesahkan versi Lucee yang berjalan, buat fail ujian ringkas dan buka melalui pelayar:

<cfoutput>Lucee #server.lucee.version#</cfoutput>

Konfigurasi peringkat aplikasi seperti this.datasource diletakkan dalam Application.cfc. Rujuk panduan Application.cfc untuk butiran. Jika anda memasang versi terkini, anda mungkin berminat dengan perubahan dalam Lucee 7 dan masa depannya.

Soalan Lazim (FAQ)

Bagaimana cara install Lucee di Ubuntu? Guna Docker (docker run -d -p 8888:8888 lucee/lucee:latest), jalankan Lucee Installer .run dengan sudo, atau letakkan lucee.jar ke dalam Tomcat. Lucee Express juga boleh dijalankan terus dari folder dengan ./bin/startup.sh.

Bagaimana cara install Lucee di Windows? Cara paling mudah ialah muat turun Lucee Express ZIP, ekstrak, dan jalankan bin\startup.bat. Untuk pengeluaran, jalankan Lucee Installer .exe sebagai Administrator dengan IIS berjalan.

Apakah port lalai Lucee? Port lalai ialah 8888 untuk Lucee Express dan imej Docker rasmi. Pemasangan lalai Lucee juga menggunakan port 8005 dan 8009 untuk Tomcat.

Adakah saya perlu memasang Java dahulu? Ya untuk kebanyakan kaedah, kecuali Lucee Installer yang membawa AdoptOpenJDK sendiri dan imej Docker yang sudah mengandungi JRE. Lucee 7.1 menggunakan Java 25 sebagai garis dasar, dan Java 21 masih disokong.

Mana satu kaedah untuk pengeluaran? Lucee Installer jika anda mahu Apache atau IIS di hadapan, atau imej Docker rasmi jika anda menggunakan kontena. Lucee Express tidak disyorkan untuk pengeluaran.

Sumber

• Downloading and Installing Lucee, docs.lucee.org
• Docker, docs.lucee.org
• Installing Lucee on Windows, docs.lucee.org
• Lucee Downloads
• Lucee on GitHub
• Lucee Official Site