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 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 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: setelan default Anda project dan region komputasi. Mengonfigurasi setelan ini akan memudahkan Anda menjalankan 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 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.
- 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
- 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 dituju. - 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:
- 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).
- 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