Langkah 1: Menentukan variabel lingkungan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Yang Anda lakukan pada langkah ini

Bagian ini menjelaskan cara menetapkan beberapa variabel lingkungan yang digunakan di seluruh dokumentasi (dan terutama dalam tutorial konfigurasi ini). Google sangat merekomendasikan agar Anda menggunakannya agar dapat memasukkan perintah seperti yang ditunjukkan.

Ini adalah langkah pertama dari dua langkah yang akan Anda lakukan di command line sebelum memulai wizard penyediaan Apigee.

Melakukan langkah

Untuk menentukan variabel lingkungan di command line:

  1. Tentukan variabel lingkungan berikut untuk project saat ini: 
    PROJECT_ID="YOUR_PROJECT_ID"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

    Dengan keterangan:

    • PROJECT_ID adalah project ID Cloud yang Anda buat sebagai bagian dari Prasyarat. Jika Anda tidak yakin dengan project ID Anda, gunakan konsol Cloud atau perintah gcloud projects list untuk menemukannya.
    • PROJECT_NUMBER adalah nomor project Cloud yang Anda buat sebagai bagian dari Prasyarat. Contoh ini mengeluarkan perintah gcloud untuk mendapatkan nomor project untuk Anda. Atau, Anda dapat menemukannya di dasbor project Konsol Google Cloud atau menggunakan perintah gcloud projects list untuk menemukannya.

    • RUNTIME_LOCATION adalah lokasi fisik tempat instance Anda berada. Nilai yang valid adalah region Compute Engine (untuk organisasi berbayar) atau zona Compute Engine (untuk organisasi evaluasi). Untuk informasi selengkapnya, lihat Lokasi Compute Engine.

    • ANALYTICS_REGION adalah lokasi fisik tempat Anda menyimpan data analisis.

      Nilai yang valid adalah subset dari region Compute Engine. Nilainya dapat berupa:

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      Akun evaluasi dan berbayar menggunakan region untuk lokasi analisis. Oleh karena itu, untuk organisasi berbayar, nilainya dapat sama dengan RUNTIME_LOCATION (juga merupakan wilayah). Namun, nilai ANALYTICS_REGION tidak harus sama dengan RUNTIME_LOCATION. Namun, mungkin ada manfaat performa jika keduanya sama.

      Untuk akun evaluasi, lokasi analisis adalah region, tetapi lokasi runtime adalah zona, sehingga keduanya tidak akan sama.

    • RUNTIME_LOCATION adalah lokasi fisik tempat key ring dan kunci aplikasi Anda disimpan. Apigee menggunakan kunci aplikasi untuk mengenkripsi data aplikasi seperti KVM, cache, dan secret klien, yang kemudian disimpan di database.

      Serupa dengan region analisis, nilai yang valid adalah subset dari region Compute Engine. Nilainya dapat sama dengan $RUNTIME_LOCATION Anda (juga wilayah), tetapi tidak harus. Mungkin ada manfaat performa jika keduanya sama.

    • RUNTIME_LOCATION adalah nama key ring tempat kunci aplikasi disimpan. Nama ring kunci harus unik untuk organisasi Anda. Jika Anda membuat region tambahan, nama key ring untuk region tersebut tidak boleh sama dengan nama key ring yang ada.
    • APPKEY_KEY_NAME adalah nama kunci aplikasi. Nama kunci aplikasi harus unik dalam key ring tertentu.
    • DISK_KEY_RING_NAME adalah nama key ring disk. Nama key ring disk harus berbeda dengan nama kunci aplikasi. Anda akan membuat key ring disk di lokasi yang sama dengan $RUNTIME_LOCATION.
    • DISK_KEY_NAME adalah nama kunci enkripsi disk, yang digunakan Apigee untuk mengenkripsi data instance runtime sebelum ditulis ke disk.

    Contoh berikut menentukan variabel lingkungan untuk organisasi berbayar. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_LOCATION="us-west1"
APPKEY_KEY_RING_NAME="us-west1"
APPKEY_KEY_NAME="us-west1"
DISK_KEY_RING_NAME="us-west1"
DISK_KEY_NAME="us-west1"

    Jika ini untuk organisasi evaluasi, RUNTIME_LOCATION akan ditetapkan ke zona, bukan region.

    Anda akan menggunakan nama variabel, seperti $PROJECT_ID sebagai literal string dalam perintah.

    Perhatikan bahwa Anda mungkin tidak menggunakan semua variabel lingkungan ini selama penyediaan dan konfigurasi.

  2. (Opsional) Periksa pekerjaan Anda dengan menampilkan nilai yang baru saja Anda tetapkan. Perhatikan bahwa saat Anda ingin menggunakan variabel dalam perintah, awali nama variabel dengan tanda dolar ($). 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_LOCATION
echo $APPKEY_KEY_RING_NAME
echo $APPKEY_KEY_NAME
echo $DISK_KEY_RING_NAME
echo $DISK_KEY_NAME

    Respons terhadap perintah echo Anda akan terlihat seperti berikut:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

Jika Anda mengalami error selama bagian proses ini, lihat Pemecahan masalah.

1 BERIKUTNYA: Mengaktifkan API 3 4 5 6 7 8