Langkah 1: Buat cluster

Saat ini Anda sedang melihat versi 1.3 dokumentasi hybrid Apigee. This version is end of life. You should upgrade to a newer version. Untuk informasi lebih lanjut, lihat Versi yang didukung.

Version 1.3 (unsupported)

Versi yang didukung:

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

Versi yang tidak didukung:

• 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 mendapatkan petunjuk. Jika Anda melakukan penginstalan baru, lanjutkan dengan konfigurasi yang dijelaskan di bawah ini.

Sebelum memulai:

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

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

Klik untuk melihat deskripsi dan perintah untuk menentukan variabel.

Langkah-langkah ini menggunakan variabel lingkungan berikut:

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

  export PROJECT_ID=your_project_ID

• ANALYTICS_REGION: Region tempat project GKE Anda berjalan.Region analisis untuk organisasi Anda. Lihat Panduan memulai Hybrid - 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 Panduan memulai Hybrid - Langkah 4: Buat organisasi

  export ORG_NAME=your_organization_name

• ENV_NAME: Nama lingkungan hybrid Anda. Lihat Panduan memulai Hybrid - 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.

Siapkan shell terminal Anda

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 shell lokal Anda. 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: project default dan region komputasi. Mengonfigurasi setelan ini mempermudah eksekusi 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 harus menambahkannya dengan perintah yang ditunjukkan di bawah ini. Jika, dari output daftar, Anda perlu mengubah setelan saat ini untuk mencerminkan region komputasi dan project, 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 direpresentasikan oleh PROJECT_ID).

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

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

gcloud container get-server-config

Jika tidak ingin menggunakan default, Anda dapat menambahkan flag --cluster-version ke perintah pembuatan cluster. 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 node, dan setelan lain yang ditentukan dalam perintah membuat cluster yang dikonfigurasi secara minimal cocok untuk penginstalan Apigee Hybrid uji coba.
   Catatan: Ukuran cluster yang akan Anda buat di langkah ini memiliki jumlah resource minimal yang cocok untuk uji coba atau pengujian saja. Untuk informasi yang lebih detail mengenai persyaratan resource cluster untuk lingkungan produksi dan non-produksi, 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 yang mirip dengan berikut ini, dengan status RUNNING, akan 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

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.

1. Pertama, cantumkan konteks untuk menentukan mana yang merupakan konteks saat ini. Dalam contoh berikut, konteks saat ini adalah gke_hybrid-project_us-central1_apigee-hybrid. Nama tersebut mencakup nama project Google Cloud (hybrid-project), 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, setel konteks saat ini ke cluster yang baru saja Anda buat (cluster tempat Anda ingin menginstal Apigee Hybrid). Dengan menggunakan output get-contexts sebelumnya, Anda dapat beralih ke konteks yang benar, seperti berikut:

   kubectl config use-context context

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

3. Periksa konteks saat ini untuk memastikan konteks telah 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 beri diri Anda peran cluster-admin:

1. Ambil kredensial dengan memasukkan perintah berikut:

   gcloud container clusters get-credentials $CLUSTER_NAME

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

   Anda akan melihat hasil yang mirip seperti 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 seperti berikut ini:

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

Ringkasan

Anda sekarang memiliki cluster Kubernetes yang berjalan di project Google Cloud. Lingkungan shell Anda sudah siap, dan Anda siap 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