Langkah 1: Buat cluster GKE

Langkah ini menjelaskan cara menyiapkan lingkungan shell dan membuat cluster GKE di project Google Cloud Platform (GCP).

Menyiapkan shell terminal

Alat gcloud menyediakan antarmuka command line utama untuk GCP, dan kubectl menyediakan antarmuka command line utama untuk menjalankan perintah terhadap cluster Kubernetes.

  1. Pastikan Anda telah menginstal gcloud dan kubectl di shell lokal. Alat gcloud menyediakan antarmuka command line utama untuk GCP, dan kubectl menyediakan antarmuka command line utama untuk menjalankan perintah terhadap cluster Kubernetes.

    gcloud -h
    kubectl -h
  2. Jika Anda belum menginstal utilitas ini, instal sekarang:
    1. Instal Cloud SDK, yang menyertakan alat command line gcloud.
    2. Setelah menginstal Cloud SDK, instal alat command line kubectl dengan menjalankan perintah berikut:
    3. gcloud components install kubectl
  3. Gunakan alat gcloud untuk mengonfigurasi dua setelan default: project dan region komputasi default Anda. Mengonfigurasi setelan ini akan memudahkan Anda menjalankan perintah gcloud, karena gcloud mengharuskan Anda menentukan project dan zona komputasi tempat Anda ingin bekerja.

    Untuk mencantumkan setelan saat ini:

    gcloud config list

    Jika project dan/atau zona komputasi tidak tercantum, Anda harus menambahkannya dengan perintah yang ditampilkan di bawah. Jika, dari output daftar, Anda memutuskan bahwa Anda perlu mengalihkan setelan saat ini untuk mencerminkan project dan region komputasi (atau zona), Anda juga dapat menggunakan perintah ini:

    gcloud config set project project-id
    gcloud config set compute/region compute-region
    gcloud config set compute/zone compute-zone
    

    Dengan project-id sebagai nama project GCP Anda, compute-region adalah nama region komputasi GCP, dan compute-zone adalah nama zona komputasi GCP. Misalnya: compute/region us-central1. Untuk mengetahui daftar region dan zona komputasi, lihat Region dan zona yang tersedia.

Membuat cluster GKE

Pada langkah ini, Anda akan membuat cluster Kubernetes di project GCP (project yang Anda tetapkan dengan perintah gcloud config).

Jalankan perintah berikut untuk membuat cluster. Jenis mesin, jumlah node, dan setelan lainnya yang ditentukan dalam perintah akan membuat cluster yang dikonfigurasi secara minimal dan cocok untuk penginstalan Apigee Hybrid uji coba.

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

Dengan cluster-name adalah nama yang Anda pilih untuk cluster.

Pembuatan cluster dapat memerlukan waktu beberapa menit. Setelah berhasil, Anda akan melihat output yang mirip dengan berikut dengan status RUNNING:

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          RUNNING

Menetapkan konteks saat ini

Konteks adalah grup parameter akses. Setiap konteks berisi cluster Kubernetes, pengguna, dan namespace. Konteks saat ini adalah cluster yang saat ini menjadi default untuk kubectl: semua perintah kubectl dijalankan pada cluster tersebut.

Pastikan konteks gcloud saat ini ditetapkan ke cluster yang baru saja Anda buat.

  1. Pertama, cantumkan konteks untuk menentukan konteks saat ini. Dalam contoh berikut, konteks saat ini adalah gke_hybrid-project_us-central1-a_apigee-hybrid. Nama tersebut mencakup nama project GCP (hybrid-project), region atau zona (us-central1-a), dan nama cluster (apigee-hybrid):
    kubectl config get-contexts
    CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
    *         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
              gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster
    
    
  2. Jika perlu, tetapkan konteks saat ini ke cluster yang baru saja Anda buat (cluster tempat Anda ingin menginstal Apigee hybrid). Dengan asumsi output get-contexts sebelumnya, jika nama cluster yang Anda buat adalah apigee-cluster di region us-west1, Anda akan beralih ke konteks gke_apigee-project_us-west1-a_apigee-cluster, sebagai berikut:
    kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster

    Dengan gke_apigee-project_us-west1-a_apigee-cluster adalah nama konteks yang akan dialihkan.

  3. Periksa konteks saat ini untuk memastikannya ditetapkan ke cluster yang diinginkan. Contoh:
    kubectl config current-context
     gke_apigee-project_us-west1-a_apigee-cluster

Memberikan kredensial cluster

Kredensial cluster memberi Anda akses ke penampung yang berjalan di cluster. Ambil kredensial Anda dan beri diri Anda peran cluster-admin:

  1. Ambil kredensial:
    gcloud container clusters get-credentials cluster-name

    Dengan cluster-name adalah nama cluster yang Anda buat (cluster tempat Anda ingin menginstal Apigee hybrid).

  2. Tetapkan binding peran cluster. Jalankan perintah ini persis seperti yang ditunjukkan:
    kubectl create clusterrolebinding cluster-admin-binding \
    --clusterrole cluster-admin --user $(gcloud config get-value account)

Ringkasan

Sekarang Anda memiliki cluster Kubernetes yang berjalan di project GCP. Lingkungan shell Anda telah disiapkan, dan Anda siap menginstal software platform runtime hybrid Apigee di komputer lokal.

1 (BERIKUTNYA) Langkah 2: Instal apigeectl 3 4