Menetapkan variabel lingkungan untuk mengonfigurasi build

Anda dapat mengonfigurasi variabel lingkungan yang ditetapkan selama proses build image container.

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

Build lokal

Untuk build lokal, Anda harus menginstal Pack CLI dan Docker.

Sebelum memulai

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

Menetapkan variabel lingkungan

Untuk menetapkan variabel lingkungan untuk build lokal, tambahkan flag --env ke perintah pack untuk setiap variabel lingkungan.

Anda dapat menggunakan satu atau beberapa variabel lingkungan yang didukung oleh runtime.

pack build SERVICE_NAME \
    --env ENVIRONMENT_VARIABLE

Ganti:

SERVICE_NAME dengan nama layanan untuk aplikasi atau fungsi Anda.
ENVIRONMENT_VARIABLE dengan variabel lingkungan yang ingin Anda tetapkan selama waktu build.

Contoh

Untuk menetapkan variabel lingkungan GOOGLE_ENTRYPOINT="gunicorn -p :8080 main:app" di image container, jalankan perintah berikut:

pack build my-app \
    --builder gcr.io/buildpacks/builder:v1 \
    --env GOOGLE_ENTRYPOINT="gunicorn -p :8080 main:app"
    --env MY-LOCAL-ENV-VARIABLE

Build jarak jauh

Untuk menetapkan variabel lingkungan untuk build jarak jauh, gunakan deskripsi project project.toml. Deskripsi project project.toml digunakan oleh Cloud Build saat image container Anda dibangun.

Sebelum memulai

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.

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

Buka pemilih project

Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

Enable the Cloud Build and Artifact Registry APIs.

Enable the APIs

Menginstal Google Cloud CLI.

Untuk initialize gcloud CLI, jalankan perintah berikut:

gcloud init

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

Buka pemilih project

Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

Enable the Cloud Build and Artifact Registry APIs.

Enable the APIs

Menginstal Google Cloud CLI.

Untuk initialize gcloud CLI, jalankan perintah berikut:

gcloud init

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.

Opsional: Mendownload contoh aplikasi

Clone repositori contoh ke komputer lokal Anda:

git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

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

Membangun aplikasi dengan variabel lingkungan

Dalam direktori root layanan Anda, buat atau update deskripsi project project.toml untuk menyertakan bagian [[build.env]] dan variabel lingkungan yang didukung:
```
[[build.env]]
    name = "ENVIRONMENT_VARIABLE_NAME"
    value = "ENVIRONMENT_VARIABLE_VALUE"
```
Ganti:
- ENVIRONMENT_VARIABLE_NAME dengan nama variabel lingkungan yang didukung.
- ENVIRONMENT_VARIABLE_VALUE dengan nilai yang sesuai untuk variabel lingkungan yang ditentukan.
Contoh
```
[[build.env]]
    name = "GOOGLE_ENTRYPOINT"
    value = "gunicorn -p :8080 main:app"
```

Gunakan gcloud untuk mengirimkan kode sumber aplikasi ke Cloud Build:

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-docker.pkg.dev
PROJECT_ID dengan ID project Google Cloud Anda.
REPO_NAME dengan nama repositori Docker Anda.
IMAGE_NAME dengan nama image container Anda.

Contoh: Jika mendownload aplikasi contoh, Anda menjalankan perintah yang sesuai:

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

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-docker.pkg.dev
- PROJECT_ID dengan ID project Google Cloud Anda.
- REPO_NAME dengan nama repositori Docker Anda.