Membangun aplikasi dengan buildpack

Panduan ini menunjukkan cara menggunakan buildpack dengan kode sumber aplikasi untuk membuat image container. Misalnya, gunakan buildpack untuk membangun kode sumber layanan Cloud Run Anda ke dalam image container.

Ada dua metode untuk membangun image container dengan buildpack:

  • Membangun secara lokal dengan CLI pack untuk menguji aplikasi Anda secara lokal dan membuat prototipe perubahan dengan cepat sebelum deployment.
  • Membangun dari jarak jauh dengan Cloud Build. Membangun dengan Cloud Build berguna untuk aplikasi besar yang memiliki proses build yang memerlukan banyak resource dan juga dapat membantu melindungi supply chain software Anda.

Build lokal

Anda menggunakan CLI pack untuk membangun aplikasi secara lokal ke dalam image container.

Sebelum memulai

  1. Instal Docker Community Edition (CE) di workstation Anda. Docker digunakan oleh pack sebagai builder image OCI.
  2. Instal Pack CLI.
  3. Instal alat Kontrol sumber Git untuk mengambil aplikasi contoh dari GitHub.

Membangun aplikasi secara lokal

Anda menggunakan perintah pack build dan menentukan --builder=gcr.io/buildpacks/builder builder default untuk membuat image container secara lokal.

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

Ganti IMAGE_NAME dengan nama image container layanan Anda. \

Anda juga dapat menyesuaikan image container dengan memperluas image build dan pengoperasian.

Membangun aplikasi sampel secara lokal

Contoh berikut menunjukkan cara membangun sampel secara lokal.

  1. Clone repositori contoh ke komputer lokal Anda:
    git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git
  2. Ubah ke direktori yang berisi kode contoh aplikasi:

    Go

    cd buildpack-samples/sample-go

    Java

    cd buildpack-samples/sample-java-gradle

    Node.js

    cd buildpack-samples/sample-node

    PHP

    cd buildpack-samples/sample-php

    Python

    cd buildpack-samples/sample-python

    Ruby

    cd buildpack-samples/sample-ruby

    .NET

    cd buildpack-samples/sample-dotnet
  3. Gunakan pack untuk membangun contoh image aplikasi:

    Go

    pack build --builder=gcr.io/buildpacks/builder sample-go

    Java

    pack build --builder=gcr.io/buildpacks/builder sample-java-gradle

    Node.js

    pack build --builder=gcr.io/buildpacks/builder sample-node

    PHP

    pack build --builder=gcr.io/buildpacks/builder sample-php

    Python

    pack build --builder=gcr.io/buildpacks/builder sample-python

    Ruby

    pack build --builder=gcr.io/buildpacks/builder sample-ruby

    .NET

    pack build --builder=gcr.io/buildpacks/builder sample-dotnet
  4. Jalankan image menggunakan docker:

    Go

    docker run -p8080:8080 sample-go

    Java

    docker run -it -ePORT=8080 -p8080:8080 sample-java-gradle

    Node.js

    docker run -it -ePORT=8080 -p8080:8080 sample-node

    PHP

    docker run -it --rm -p 8080:8080 sample-php

    Python

    docker run -it -ePORT=8080 -p8080:8080 sample-python

    Ruby

    docker run -it -ePORT=8080 -p8080:8080 sample-ruby

    .NET

    docker run -it -ePORT=8080 -p8080:8080 sample-dotnet
  5. Buka aplikasi yang sedang berjalan dengan mengakses localhost:8080.

Build jarak jauh

Gunakan Cloud Build untuk membangun aplikasi Anda ke dalam image container dan Artifact Registry sebagai repositori container tempat Anda menyimpan dan men-deploy setiap image.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Cloud Build and Artifact Registry.

    Mengaktifkan API

  5. Menginstal Google Cloud CLI.
  6. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init
  7. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  8. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  9. Aktifkan API Cloud Build and Artifact Registry.

    Mengaktifkan API

  10. Menginstal Google Cloud CLI.
  11. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init
  12. Pastikan project Google Cloud Anda memiliki akses ke repositori image container.

    Untuk mengonfigurasi akses ke repositori Docker di Artifact Registry:

    1. Buat repositori Docker baru di lokasi yang sama dengan project Google Cloud Anda.
      gcloud artifacts repositories create REPO_NAME \
      --repository-format=docker \
      --location=REGION --description="DESCRIPTION"
      Ganti:
      • REPO_NAME dengan nama yang Anda pilih untuk repositori Docker.
      • REGION dengan lokasi di atau yang terdekat dengan lokasi project Google Cloud Anda.
      • DESCRIPTION dengan deskripsi pilihan Anda.

      Misalnya, untuk membuat repositori docker di us-west2 dengan deskripsi "repository Docker", jalankan:

      gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
      --location=us-west2 --description="Docker repository"
    2. Pastikan repositori Anda telah dibuat:
      gcloud artifacts repositories list

      Anda akan melihat nama yang dipilih untuk repositori Docker Anda dalam daftar.

Membangun aplikasi dari jarak jauh

Anda menggunakan perintah gcloud builds submit untuk membangun dan mengupload image container ke repositori.

Anda dapat memilih untuk menentukan image container dalam perintah itu sendiri atau menggunakan file konfigurasi.

Membangun dengan perintah

Untuk membangun tanpa file konfigurasi, tentukan flag image:

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

Ganti:

  • LOCATION dengan nama region repositori container Anda. Contoh: us-west2
  • PROJECT_ID dengan ID project Google Cloud Anda.
  • REPO_NAME dengan nama repositori Docker Anda.
  • IMAGE_NAME dengan nama image container Anda.

Contoh:

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo/app-image

Membangun dengan file konfigurasi

Anda dapat menggunakan file konfigurasi untuk menentukan detail konfigurasi repositori image cukup dengan perintah build. File konfigurasi menggunakan format file YAML dan harus menyertakan langkah build yang menggunakan CLI pack.

  1. Buat nama file YAML cloudbuild.yaml yang menyertakan URI repositori image container Anda.

    options:
      logging: CLOUD_LOGGING_ONLY
      pool: {}
    projectId: PROJECT_ID
    steps:
    - name: gcr.io/k8s-skaffold/pack
      entrypoint: pack
      args:
      - build
      - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
      - --builder
      - gcr.io/buildpacks/builder:latest
      - --network
      - cloudbuild
    

    Ganti:

    • LOCATION dengan nama region repositori container Anda. Contoh:us-west2
    • PROJECT_ID dengan ID project Google Cloud Anda.
    • REPO_NAME dengan nama repositori Docker Anda.
    • IMAGE_NAME dengan nama image container Anda.
  2. Bangun aplikasi.

    Jika file konfigurasi diberi nama cloudbuild.yaml, Anda dapat menjalankan perintah berikut:

    gcloud builds submit .
    

Contoh: Membangun sampel aplikasi dari jarak jauh

Contoh berikut menunjukkan cara membangun sampel dari jarak jauh, lalu memverifikasi bahwa image container telah dikirim ke repositori Anda di Artifact Registry.

  1. Clone repositori contoh ke komputer lokal Anda:
    git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git
  2. Ubah ke direktori yang berisi kode contoh aplikasi:

    Go

    cd buildpack-samples/sample-go

    Java

    cd buildpack-samples/sample-java-gradle

    Node.js

    cd buildpack-samples/sample-node

    PHP

    cd buildpack-samples/sample-php

    Python

    cd buildpack-samples/sample-python

    Ruby

    cd buildpack-samples/sample-ruby

    .NET

    cd buildpack-samples/sample-dotnet
  3. Gunakan gcloud untuk mengirimkan kode sumber aplikasi ke Cloud Build:

    Go

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-go

    Java

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-java-gradle

    Node.js

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-node

    PHP

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-php

    Python

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-python

    Ruby

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-ruby

    .NET

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-dotnet
  4. Pastikan bahwa sampel aplikasi berhasil dipublikasikan ke REPO_NAME:
    gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

    Ganti:

    • LOCATION dengan nama region repositori container Anda. Contoh: us-west2
    • PROJECT_ID dengan ID project Google Cloud Anda.
    • REPO_NAME dengan nama repositori Docker Anda.

Langkah Berikutnya