Untuk membangun dan menerapkan aplikasi dengan cepat dan sukses, disarankan melakukan debug buildpacks secara lokal. Debug lokal membantu mengidentifikasi dan menyelesaikan masalah dengan lebih cepat, mengurangi risiko kegagalan penerapan, serta meningkatkan efisiensi pengembangan.
Persiapan
Persiapan Jaringan
Pastikan akses normal ke Docker Hub dari lingkungan lokal Anda karena gambar kontainer terkait buildpacks di-host di sana.
Instal Docker
Sebelum menggunakan alat Pack, instal Docker pada sistem Anda. Untuk sistem operasi Alibaba Cloud Linux, gunakan perintah instalasi berikut:
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum makecache yum install -y curl git docker-ce systemctl enable docker && systemctl start dockerKode Aplikasi: Pastikan repositori kode aplikasi Anda sudah siap.
Prosedur
Langkah 1: Instal alat Pack
Unduh dan instal alat Pack menggunakan perintah berikut. Contoh ini untuk sistem operasi Alibaba Cloud Linux.
# Unduh dan instal pack
PACK_VERSION="0.36.4"
DOWNLOAD_URL="https://github.com/buildpacks/pack/releases/download/v${PACK_VERSION}/pack-v${PACK_VERSION}-linux.tgz"
CHECKSUM_URL="${DOWNLOAD_URL}.sha256"
# Unduh dan verifikasi file pack
echo "Mengunduh pack v${PACK_VERSION}..."
if ! curl -fsSL "$DOWNLOAD_URL" -o pack-v${PACK_VERSION}-linux.tgz; then
echo "Gagal mengunduh pack v${PACK_VERSION}."
exit 1
fi
echo "Pengunduhan selesai."
echo "Memverifikasi checksum..."
if ! curl -fsSL "$CHECKSUM_URL" -o pack.tgz.sha256; then
echo "Gagal mengunduh file checksum."
exit 1
fi
if ! sha256sum --check --status pack.tgz.sha256; then
echo "Verifikasi checksum gagal."
exit 1
fi
echo "Checksum diverifikasi dengan sukses."
tar xvzf pack-v${PACK_VERSION}-linux.tgz -C /usr/local/bin/
# Periksa apakah instalasi berhasil
pack --versionLangkah 2: Gunakan alat Pack untuk mendebug aplikasi
Bangun aplikasi dan buat gambar menggunakan perintah
pack build.Perintah: Ganti
<your-image-name>dengan nama gambar kontainer yang akan dibuat, dan ganti Ganti dengan nama gambar kontainer yang akan dibuat,<path-to-your-app>dengan jalur lokal kode aplikasi.pack build <your-image-name> --path <path-to-your-app> --builder heroku/builder:24Contoh: Dalam contoh ini, nama gambar adalah
my-app, dan jalurnya adalah./my-app.pack build my-app --path ./my-app --builder heroku/builder:24
Jalankan gambar yang dihasilkan dengan perintah berikut.
# Tentukan variabel lingkungan dan port sesuai dengan kode aplikasi Anda docker run -e PORT=8080 -p8080:8080 my-appAkses
http://localhost:<port-number>untuk menguji aplikasi Anda.Dalam contoh ini, ganti
<port-number>dengan8080.
Langkah 3: Debug dan sesuaikan aplikasi
Jika aplikasi mengalami masalah selama proses pembuatan atau waktu proses, lakukan debug dan sesuaikan sesuai kebutuhan.
Periksa log pembuatan aplikasi.
Untuk log pembuatan yang lebih rinci, gunakan parameter
--verbose. Perintahnya adalah sebagai berikut:pack build my-app --path ./my-app --builder heroku/builder:24 --verboseUbah kode aplikasi dan lakukan debug kembali.
Berdasarkan informasi debugging, ubah kode dan jalankan
pack buildsekali lagi.Tambahkan variabel lingkungan.
Lewati variabel lingkungan menggunakan opsi
--env. Perintahnya adalah sebagai berikut:pack build my-app --path ./my-app --builder heroku/builder:24 --env MY_ENV=productionLakukan pengujian dan verifikasi lokal lebih lanjut.
Pastikan fungsionalitas dan performa aplikasi memenuhi persyaratan dengan menjalankan dan mengujinya dalam kontainer.
Referensi
Untuk masalah spesifik terkait buildpacks, lihat Konfigurasikan aplikasi dalam bahasa pemrograman tertentu atau dokumentasi resmi buildpacks.
Merujuk pada dokumentasi untuk Cloud Native buildpacks tertentu jika Anda menggunakan buildpacks pihak ketiga yang ditentukan dalam
project.toml.