Langkah 1: Buat cluster

Anda sedang melihat versi 1.3 Dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.3 (unsupported)

Versi yang didukung:

• v1.13 (terbaru)                        
• v1.12                         
• v1.11                         
• Daftar versi yang didukung

Versi yang tidak didukung:

• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Mengupgrade: Jika Anda mengupgrade ke Apigee Hybrid v1.3.6, lihat Mengupgrade Apigee Hybrid untuk mengetahui petunjuknya. Jika Anda melakukan penginstalan baru, lanjutkan dengan konfigurasi yang dijelaskan di bawah.

Sebelum memulai:

Langkah-langkah ini mengasumsikan bahwa Anda telah membuat variabel lingkungan di langkah sebelumnya. Periksa dengan perintah berikut:

echo $PROJECT_ID
echo $ANALYTICS_REGION
echo $ORG_NAME
echo $ENV_NAME

Klik deskripsi dan perintah untuk menentukan variabel.

Langkah-langkah ini menggunakan variabel lingkungan berikut:

• PROJECT_ID: ID project Google Cloud Anda. Lihat Hybrid panduan memulai - Langkah 2: Buat project Google Cloud

  export PROJECT_ID=your_project_ID

• ANALYTICS_REGION: Region tempat project GKE Anda dijalankan.Region analisis untuk organisasi Anda. Lihat Hybrid panduan memulai - Langkah 4: Buat organisasi

  export ANALYTICS_REGION=your_analytics region

• ORG_NAME: Nama organisasi Anda. ID ini harus cocok dengan ID project Google Cloud Anda. Lihat Hybrid panduan memulai - Langkah 4: Buat organisasi

  export ORG_NAME=your_organization_name

• ENV_NAME: Nama lingkungan hybrid Anda. Lihat Hybrid panduan memulai - Langkah 6: Membuat grup lingkungan

  export ENV_NAME=your_environment_name

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

Menyiapkan shell terminal

Alat gcloud menyediakan antarmuka command line utama untuk Google Cloud, sedangkan 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 Google Cloud, 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 seperti berikut:
   1. Instal Cloud SDK, yang mencakup alat command line gcloud.
   2. Setelah menginstal Cloud SDK, instal alat command line kubectl dengan menjalankan perintah berikut:

   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 region komputasi tempat Anda ingin bekerja.

   Untuk menampilkan setelan saat ini, jalankan perintah berikut:

   gcloud config list

   Jika project dan/atau region 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 komputasi, Anda juga dapat menggunakan perintah berikut:

   gcloud config set project $PROJECT_ID
   gcloud config set compute/region $ANALYTICS_REGION
   

   Dengan keterangan:

   • PROJECT_ID adalah nama project Google Cloud Anda.
   • ANALYTICS_REGION adalah nama region komputasi Google Cloud

Membuat cluster GKE

Perhatian: Apigee tidak mendukung GKE Sandbox atau gVisor.

Pada langkah ini, Anda akan membuat cluster Kubernetes di project Google Cloud (project yang Anda tetapkan dengan perintah gcloud config yang diwakili oleh PROJECT_ID).

Catatan: Perintah berikut mengasumsikan bahwa Anda menetapkan konfigurasi gcloud untuk region komputasi, seperti yang dijelaskan di langkah sebelumnya. Jika Anda tidak mengatur konfigurasi, maka Anda akan memerlukan untuk menambahkan parameter --region "compute-region" ke perintah.

Catatan: Sebaiknya periksa versi Kubernetes default dan pastikan versi tersebut memenuhi versi tersebut persyaratan yang tercantum di Platform yang didukung. Untuk menentukan versi Kubernetes yang merupakan versi default, gunakan perintah berikut:

gcloud container get-server-config

Jika tidak ingin menggunakan default, Anda dapat menambahkan flag --cluster-version ke cluster pembuatan perintah. Untuk mengetahui detailnya, lihat gcloud container clusters create.

Membuat cluster

1. Buat variabel lingkungan CLUSTER_NAME dengan perintah berikut (opsional):

   export CLUSTER_NAME=cluster-name

   Dengan cluster-name adalah nama yang Anda pilih untuk cluster.

2. 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 melakukan uji coba penginstalan hybrid Apigee.
   Catatan: Ukuran cluster yang akan Anda buat di sini memiliki jumlah resource minimal yang hanya cocok untuk uji coba atau pengujian. Untuk lebih detail informasi, tentang persyaratan resource cluster untuk produksi dan non-produksi Google Cloud Platform, lihat:

   • Persyaratan cluster produksi GKE
   • Persyaratan cluster non-produksi GKE

   gcloud container clusters create $CLUSTER_NAME \
   --machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"

   Pembuatan cluster dapat memerlukan waktu beberapa menit. Setelah berhasil, output mirip seperti berikut ini, dengan status RUNNING ditampilkan:

   NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
   apigee-hybrid  us-central1    1.15.12-gke.2   35.222.54.89  e2-standard-4  1.15.12-gke.2             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_apigee-hybrid. Nama tersebut mencakup nama project Google Cloud (hybrid-project), yakni sebuah region (us-central1), dan nama cluster (apigee-hybrid).

   kubectl config get-contexts

   Hasilnya akan terlihat seperti contoh berikut:

   CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
   *         gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid
             gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster
   

2. Jika perlu, tetapkan konteks saat ini ke cluster yang baru saja Anda buat (cluster tempat Anda ingin menginstal Apigee Hybrid). Menggunakan get-contexts versi sebelumnya Anda dapat beralih ke konteks yang benar, sebagai berikut:

   kubectl config use-context context

   Dengan context adalah nama konteks lengkap untuk cluster Anda sebagai output oleh perintah get-contexts sebelumnya. Sebagai contoh: gke_apigee-project_us-west1_apigee-cluster.

3. Periksa konteks saat ini untuk memastikan konteks sudah disetel ke cluster yang diinginkan menggunakan perintah berikut:

   kubectl config current-context

   Contoh:

   gke_apigee-project_us-west1_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 dengan memasukkan perintah berikut:

   gcloud container clusters get-credentials $CLUSTER_NAME

   Dengan CLUSTER_NAME adalah nama adalah nama cluster yang Anda yang dibuat (cluster tempat Anda ingin menginstal Apigee Hybrid).

   Anda akan melihat hasil yang mirip dengan berikut ini:

   Fetching cluster endpoint and auth data.
   kubeconfig entry generated for example-cluster.

2. Menetapkan binding peran cluster. Jalankan perintah berikut persis seperti yang ditunjukkan:

   kubectl create clusterrolebinding cluster-admin-binding \
   --clusterrole cluster-admin --user $(gcloud config get-value account)

   Anda akan melihat hasil yang mirip dengan berikut ini:

   clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created

Ringkasan

Sekarang Anda memiliki cluster Kubernetes yang berjalan di project Google Cloud Anda. Lingkungan shell Anda adalah menyiapkan, dan Anda siap untuk menginstal layanan cert-manager dan istio yang diperlukan oleh Apigee Hybrid di komputer lokal Anda.

1 (BERIKUTNYA) Langkah 2: Instal pengelola sertifikat dan ASM 3 4 5