Langkah 1: Buat cluster

Anda saat ini melihat versi 1.3 dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk 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 mendapatkan petunjuk. 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 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: Membuat 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 campuran - Langkah 4: Membuat organisasi

  export ANALYTICS_REGION=your_analytics region

• ORG_NAME: Nama organisasi Anda. ID ini harus cocok dengan project ID Google Cloud Anda. Lihat Mulai cepat campuran - Langkah 4: Membuat 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.

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. 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 menyertakan 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 dan region komputasi default Anda. Mengonfigurasi setelan ini akan memudahkan Anda 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 memutuskan bahwa Anda perlu mengalihkan setelan saat ini untuk mencerminkan project dan region komputasi, Anda juga dapat menggunakan perintah ini:

   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 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 versi 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 lainnya yang ditentukan dalam perintah akan membuat cluster yang dikonfigurasi secara minimal dan cocok untuk penginstalan Apigee Hybrid uji coba.
   Catatan: Ukuran cluster yang akan Anda buat di langkah ini memiliki jumlah resource minimal yang hanya cocok untuk uji coba atau pengujian. Untuk informasi selengkapnya 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. 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

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, cantumkan konteks untuk menentukan 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, 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 sebagai output dari perintah get-contexts sebelumnya. Misalnya: gke_apigee-project_us-west1_apigee-cluster.

3. Periksa konteks saat ini untuk memastikannya ditetapkan 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 penampung yang berjalan di cluster. Ambil kredensial Anda 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 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. Lingkungan shell Anda telah disiapkan, dan Anda siap menginstal layanan cert-manager dan istio yang diperlukan oleh Apigee hybrid di komputer lokal.

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