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 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 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: setelan default Anda project dan region komputasi. Mengonfigurasi setelan ini akan memudahkan Anda menjalankan 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 perlu menambahkannya dengan perintah yang ditampilkan di bawah ini. Jika, dari output daftar, Anda menentukan bahwa Anda perlu mengganti setelan saat ini untuk mencerminkan project dan region (atau zona) komputasi, Anda juga dapat menggunakan perintah berikut:

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

    Dengan project-id adalah 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 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 {i>node<i}, dan setelan lain yang ditentukan dalam perintah membuat cluster terkonfigurasi minimal yang cocok untuk uji coba penginstalan hybrid Apigee:

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 kode berikut 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

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 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 konteks saat ini. Di kolom 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, 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 dituju.

  3. Periksa konteks saat ini untuk memastikannya 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 berikan peran cluster-admin kepada diri Anda sendiri:

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

Sekarang Anda memiliki cluster Kubernetes yang berjalan di project GCP Anda. Lingkungan shell Anda adalah penyiapan, dan Anda siap menginstal software bidang runtime Apigee Hybrid di komputer lokal Anda.

1 (BERIKUTNYA) Langkah 2: Instal apigeectl 3 4