Local debug buildpacks build

Step 1: Install the Pack tool

Download and install the Pack tool. The following example uses Alibaba Cloud Linux.

# Download and install 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"
# Download and verify the pack file
echo "Downloading pack v${PACK_VERSION}..."
if ! curl -fsSL "$DOWNLOAD_URL" -o pack-v${PACK_VERSION}-linux.tgz; then
    echo "Failed to download pack v${PACK_VERSION}."
    exit 1
fi
echo "Downloading completed."
echo "Verifying checksum..."
if ! curl -fsSL "$CHECKSUM_URL" -o pack.tgz.sha256; then
    echo "Failed to download checksum file."
    exit 1
fi
if ! sha256sum --check --status pack.tgz.sha256; then
    echo "Checksum verification failed."
    exit 1
fi
echo "Checksum verified successfully."
tar xvzf pack-v${PACK_VERSION}-linux.tgz -C /usr/local/bin/

# Check if the installation was successful
pack --version

Step 2: Use the Pack tool to debug the application

1. Build the application and create an image using the pack build command.

   • Command: Replace <your-image-name> with the name of the container image to be generated, and replace Replace with the name of the container image to be generated,<path-to-your-app> with the local path of the application code.

     pack build <your-image-name> --path <path-to-your-app> --builder heroku/builder:24

   • Example: In this example, the image name is my-app, and the path is ./my-app.

     pack build my-app --path ./my-app --builder heroku/builder:24

2. Run the generated image with the following command.

   # Specify environment variables and ports according to your application code
   docker run -e PORT=8080 -p8080:8080 my-app

3. Access http://localhost:<port-number> to test your application.

   In this example, replace <port-number> with 8080.

Step 3: Debug and adapt the application

If the application encounters issues during the build or at runtime, debug and adapt it as needed.

1. Examine the application build logs.

   For detailed build logs, use the --verbose parameter. The command is as follows:

   pack build my-app --path ./my-app --builder heroku/builder:24 --verbose

2. Modify the application code and debug once more.

   Based on the debugging information, modify the code and execute pack build once more.

3. Incorporate environment variables.

   Pass environment variables using the --env option. The command is as follows:

   pack build my-app --path ./my-app --builder heroku/builder:24 --env MY_ENV=production

4. Conduct further local testing and verification.

   Ensure the application's functionality and performance meet the requirements by running and testing it within the container.