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.
Pastikan Anda telah menginstal
gcloud
dankubectl
di shell lokal Anda. Alatgcloud
menyediakan antarmuka command line utama untuk GCP, sedangkankubectl
menyediakan antarmuka command line utama untuk menjalankan perintah terhadap cluster Kubernetes.gcloud -h
kubectl -h
- Jika Anda belum menginstal utilitas tersebut, instal sekarang:
- Instal Cloud SDK, yang mencakup alat command line
gcloud
. - Setelah menginstal Cloud SDK, instal alat command line
kubectl
dengan menjalankan perintah berikut:
gcloud components install kubectl
- Instal Cloud SDK, yang mencakup alat command line
-
Gunakan alat
gcloud
untuk mengonfigurasi dua setelan default: project default dan region komputasi. Mengonfigurasi setelan ini mempermudah eksekusi perintahgcloud
, karenagcloud
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.
- 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
- 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 adalahapigee-cluster
di regionus-west1
, Anda akan beralih ke konteksgke_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. - 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:
- 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).
- 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