Langkah 1: Buat cluster

Saat ini Anda melihat versi 1.3 dari 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)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• 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 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 guna 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 Mulai cepat Hybrid - Langkah 4: Buat organisasi

  export ANALYTICS_REGION=your_analytics region

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

  export ORG_NAME=your_organization_name

• ENV_NAME: Nama lingkungan hybrid Anda. Lihat Panduan memulai hybrid - Langkah 6: Buat 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, dan 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, dan kubectl menyediakan antarmuka command line utama untuk menjalankan perintah terhadap cluster Kubernetes.

   gcloud -h
   kubectl -h

2. Jika Anda belum menginstal utilitas ini, instal sekarang sebagai 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 default Anda. Mengonfigurasi setelan ini akan mempermudah menjalankan perintah gcloud, karena gcloud mengharuskan Anda menentukan project dan region komputasi tempat Anda ingin bekerja.

   Untuk mencantumkan setelan saat ini, jalankan perintah berikut:

   gcloud config list

   Jika project dan/atau region komputasi tidak tercantum, Anda harus menambahkannya dengan perintah yang ditampilkan di bawah. Jika, dari output daftar, Anda menentukan bahwa Anda perlu mengalihkan setelan saat ini untuk mencerminkan project dan region komputasi Anda, Anda juga dapat menggunakan perintah berikut:

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

   Dengan:

   • 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 Anda telah menetapkan konfigurasi gcloud untuk region komputasi, seperti yang dijelaskan di langkah-langkah sebelumnya. Jika Anda tidak menyetel 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 dalam Platform yang didukung. Untuk menentukan versi Kubernetes mana yang menjadi default, gunakan perintah berikut:

gcloud container get-server-config

Jika tidak ingin menggunakan default, Anda dapat menambahkan tanda --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 dan cocok untuk penginstalan Apigee Hybrid uji coba.
   Catatan: Ukuran cluster yang akan Anda buat pada langkah ini memiliki jumlah minimum resource yang sesuai untuk uji coba atau pengujian saja. Untuk informasi yang lebih mendetail tentang 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. Jika 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

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.

1. Pertama, buat daftar konteks untuk menentukan mana yang merupakan konteks saat ini. Dalam contoh berikut, konteks saat ini adalah gke_hybrid-project_us-central1_apigee-hybrid. Nama ini 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, tetapkan 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, sebagai berikut:

   kubectl config use-context context

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

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

1. Ambil kredensial dengan memasukkan perintah berikut:

   gcloud container clusters get-credentials $CLUSTER_NAME

   Dengan CLUSTER_NAME adalah nama cluster yang Anda buat (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. Tetapkan binding peran cluster. Jalankan perintah berikut persis seperti yang ditampilkan:

   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 sudah disiapkan, dan Anda siap menginstal layanan cert-manager dan istio yang diperlukan oleh Apigee Hybrid di komputer lokal Anda.

1 (BERIKUTNYA) Langkah 2: Instal cert-manager dan ASM 3 4 5