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