全部产品
Search
文档中心

CloudOps Orchestration Service:Pembuatan buildpacks debug lokal

更新时间:Jul 02, 2025

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 docker
  • Kode 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 --version

Langkah 2: Gunakan alat Pack untuk mendebug aplikasi

  1. 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:24
    • Contoh: Dalam contoh ini, nama gambar adalah my-app, dan jalurnya adalah ./my-app.

      pack build my-app --path ./my-app --builder heroku/builder:24
  2. 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-app
  3. Akses http://localhost:<port-number> untuk menguji aplikasi Anda.

    Dalam contoh ini, ganti <port-number> dengan 8080.

Langkah 3: Debug dan sesuaikan aplikasi

Jika aplikasi mengalami masalah selama proses pembuatan atau waktu proses, lakukan debug dan sesuaikan sesuai kebutuhan.

  1. 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 --verbose
  2. Ubah kode aplikasi dan lakukan debug kembali.

    Berdasarkan informasi debugging, ubah kode dan jalankan pack build sekali lagi.

  3. 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=production
  4. Lakukan pengujian dan verifikasi lokal lebih lanjut.

    Pastikan fungsionalitas dan performa aplikasi memenuhi persyaratan dengan menjalankan dan mengujinya dalam kontainer.

Referensi