Langkah 1: Buat cluster GKE

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

Siapkan shell terminal Anda

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

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

    gcloud -h
    kubectl -h
  2. Jika Anda belum menginstal utilitas tersebut, instal sekarang:
    1. Instal Cloud SDK, yang mencakup 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 default dan region komputasi. Mengonfigurasi setelan ini mempermudah eksekusi perintah gcloud, karena gcloud mengharuskan Anda menentukan project dan zona komputasi tempat Anda ingin bekerja.

    Untuk menampilkan daftar setelan saat ini:

    gcloud config list

    Jika project dan/atau zona komputasi tidak tercantum, Anda harus menambahkannya dengan perintah yang ditunjukkan di bawah ini. Jika, dari output daftar, Anda menentukan bahwa Anda perlu mengubah setelan saat ini untuk mencerminkan region (atau zona) project dan komputasi, 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. Contoh: 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 lain yang ditentukan dalam perintah ini membuat cluster yang dikonfigurasi secara minimal 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 ini dengan status RUNNING:

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

Menyetel konteks saat ini

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

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

  1. Pertama, cantumkan konteks untuk menentukan mana yang merupakan konteks saat ini. Dalam contoh berikut, konteks saat ini adalah gke_hybrid-project_us-central1-a_apigee-hybrid. Nama 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, setel 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, seperti 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 digunakan.

  3. Periksa konteks saat ini untuk memastikan konteks sudah disetel 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 container yang berjalan di cluster. Ambil kredensial dan beri diri Anda peran cluster-admin:

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

    Dalam hal ini, cluster-name adalah nama cluster yang Anda buat (cluster tempat Anda ingin menginstal Apigee Hybrid).

  2. Menetapkan 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

Anda sekarang memiliki cluster Kubernetes yang berjalan di project GCP. Lingkungan shell Anda sudah siap, dan Anda siap menginstal software bidang runtime hybrid Apigee di mesin lokal Anda.

1 (BERIKUTNYA) Langkah 2: Instal apigeectl 3 4