Langkah 1: Buat cluster

Saat ini Anda melihat versi 1.6 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.6 (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                                         

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 $CLUSTER_LOCATION
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

• CLUSTER_LOCATION: Region tempat Anda akan membuat cluster.

  export CLUSTER_LOCATION=cluster-region

  Catatan: Apigee merekomendasikan agar Anda menggunakan nama region dan bukan nama zona. Region adalah lokasi geografis spesifik tempat Anda dapat menghosting resource. Region dapat memiliki beberapa zona. Misalnya, us-west1 region menunjukkan region di pesisir barat Amerika Serikat yang memiliki tiga zona: us-west1-a, us-west1-b, and us-west1-c. Region yang tersedia tercantum di Region dan zona yang tersedia. Perlu diketahui bahwa, misalnya, us-west1 adalah nama region yang valid, sedangkan us-west1-a adalah zona di region tersebut. Untuk sebagian besar penginstalan hibrida, gunakan nama region untuk variabel CLUSTER_LOCATION.
• 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

Prosedur ini menjelaskan cara menyiapkan cluster tempat Anda akan menjalankan Apigee Hybrid. Petunjuknya bervariasi bergantung pada platform tempat Anda menjalankan hybrid. Pilih platform Anda untuk melihat petunjuknya.

GKE

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

Perhatian: Apigee tidak mendukung GKE Sandbox atau gVisor untuk penginstalan hybrid di GKE.

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster hybrid Apigee: Konfigurasi minimum untuk cluster Anda adalah:

   Konfigurasi	Node pool stateful	Node pool stateless
   Jumlah node	3 (per wilayah)	3 (per wilayah)
   CPU	4	4
   RAM	15	15
   Nama label default	apigee-data	apigee-runtime
   Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

   Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

2. Periksa versi GKE yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster regional dengan minimal 6 node:
   • Membuat cluster regional.
     Apigee merekomendasikan pembuatan cluster regional. Jika Anda lebih memilih membuat cluster zona, pastikan untuk menggunakan zona tempat petunjuk meminta lokasi Anda di langkah-langkah berikutnya.
     Tips: Jika Anda tidak membuat cluster di jaringan default, ikuti petunjuk di Membuat cluster di subnet yang ada
4. Buat minimal dua node pool untuk cluster Anda. Persyaratan kumpulan node minimum adalah:

   Nama node pool default	Deskripsi	Node minimum	CPU minimum per node pool	CPU minimum per node
   apigee-data	Node pool stateful.	3	4	4/jumlah node di pool
   apigee-runtime	Node pool stateless.	3	4	4/jumlah node di pool

   Ikuti petunjuk di Menambahkan dan mengelola node pool.

   Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

5. Setelah membuat cluster, aktifkan workload identity di cluster dengan perintah berikut:

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=$PROJECT_ID.svc.id.goog \
     --region ${CLUSTER_LOCATION}

   Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Workload Identity di cluster

   Catatan: Jika Anda membuat cluster zonal, bukan cluster regional, gunakan argumen --zone, bukan --region seperti pada perintah berikut:

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=$PROJECT_ID.svc.id.goog \
     --zone ${CLUSTER_LOCATION}

6. Dapatkan kredensial gcloud dari cluster yang baru saja Anda buat dengan perintah berikut:

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --region ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

   Catatan: Jika Anda membuat cluster zona, bukan cluster regional, dapatkan kredensial dengan perintah berikut:

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --zone ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

Setelah menginstal dan menjalankan cluster, lanjutkan ke langkah berikutnya.

GKE on prem

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Node pool stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi GKE yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster pengguna:
   • Buat cluster pengguna (panduan memulai) dalam dokumentasi GKE on-prem.

Setelah menginstal dan menjalankan cluster, lanjutkan ke langkah berikutnya.

Anthos on bare metal

Persyaratan dan prasyarat

Dengan cluster Anthos on bare metal, Anda dapat menjalankan cluster Kubernetes langsung di resource mesin Anda sendiri.

Tinjau persyaratan dan prasyarat berikut:

• Persyaratan hardware: Mengonfigurasi hardware untuk cluster Anthos on bare metal
• Ringkasan prasyarat penginstalan

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Node pool stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi GKE yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut dalam dokumentasi Anthos clusters on bare metal untuk membuat cluster pengguna:
   • Membuat cluster: ringkasan.
   • Mulai cepat cluster Anthos on bare metal dalam dokumentasi cluster Anthos on bare metal.

Setelah menginstal dan menjalankan cluster, lanjutkan ke langkah berikutnya.

AKS

Membuat cluster AKS

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Node pool stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi AKS yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan salah satu set petunjuk berikut untuk membuat cluster:
   • Menggunakan Azure CLI: Panduan memulai: Men-deploy cluster Azure Kubernetes Service menggunakan Azure CLI.
   • Menggunakan Azure Portal: Mulai Cepat: Men-deploy cluster Azure Kubernetes Service (AKS) menggunakan Azure portal.

EKS

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Node pool stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi EKS yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster pengguna:
   • Dokumentasi ringkasan EKS.
   • Membuat cluster Amazon EKS.

Setelah menginstal dan menjalankan cluster, lanjutkan ke langkah berikutnya.

GKE di AWS

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Node pool stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi GKE yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster pengguna:
   • Dokumentasi ringkasan GKE di AWS.
   • Ringkasan penginstalan Anthos clusters on AWS.

Setelah menginstal dan menjalankan cluster, lanjutkan ke langkah berikutnya.

OpenShift

Membuat cluster

1. Kumpulkan persyaratan cluster Anda untuk cluster Apigee Hybrid:
   • Konfigurasi minimum untuk cluster Anda adalah:

     Konfigurasi	Node pool stateful	Node pool stateless
     Jumlah node	3 (per wilayah)	3 (per wilayah)
     CPU	4	4
     RAM	15	15
     Nama label default	apigee-data	apigee-runtime
     Penyimpanan	dinamis	Dikelola dengan CRD ApigeeDeployment

     Untuk mengetahui detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua node pool:

     Nama node pool default	Deskripsi
     apigee-data	Node pool stateful.
     apigee-runtime	Kumpulan node stateless.

     Untuk mengetahui detail selengkapnya tentang konfigurasi node pool, lihat: Mengonfigurasi node pool khusus

2. Periksa versi GKE yang didukung oleh versi hybrid 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk menginstal Apigee di cluster pengguna OpenShift dan mendaftarkannya ke GKE Hub.
   Jika Anda belum memiliki cluster OpenShift yang siap digunakan dengan Apigee, lihat petunjuk dalam dokumentasi OpenShift, misalnya: Menginstal cluster dengan cepat di Google Cloud.
   1. Instal dan konfigurasi alat CLI oc. Lihat bagian Memulai CLI OpenShift di dokumentasi OpenShift.
   2. Mendaftar dengan GKE Hub
      1. Buat file bernama gke-connect-scc.yaml dengan konten berikut:

         # Connect Agent SCC
         apiVersion: v1
         kind: SecurityContextConstraints
         metadata:
           name: gke-connect-scc
         allowPrivilegeEscalation: false
         requiredDropCapabilities:
         - ALL
         runAsUser:
           type: MustRunAsNonRoot
         seLinuxContext:
           type: RunAsAny
         supplementalGroups:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         fsGroup:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         volumes:
         - secret
         readOnlyRootFilesystem: true
         seccompProfiles:
         - docker/default
         users:
         groups:
           - system:serviceaccounts:gke-connect
                 

      2. Buat komponen di oc dengan perintah berikut:

         oc create -f gke-connect-scc.yaml

      3. Buat variabel lingkungan untuk konteks dengan perintah berikut:

         export KUBECONFIG=<> # Cluster kubeconfig file path
         export CONTEXT=admin

      4. Daftar ke GKE Hub dengan perintah berikut:

         gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \
           --kubeconfig=${KUBECONFIG} \
           --context=${CONTEXT} \
           --service-account-key-file=KEY_FILE_PATH

         Dengan:

         • PROJECT_ID adalah ID project Google Cloud Anda.
         • CLUSTER_NAME adalah nama cluster yang baru saja Anda buat.
         • KUBECONFIG adalah jalur ke file kubeconfig cluster Anda.
         • CONTEXT adalah konteks saat gcloud mendaftarkan cluster. CONTEXT harus berupa admin untuk perintah ini.
         • KEY_FILE_PATH adalah jalur ke file kunci akun layanan Anda, misalnya ./dist/apigee-my-project-ro-sa.json. Akun layanan harus memiliki dua peran IAM berikut:
           • GKE Hub Admin
           • GKE Connect Agent

Setelah menginstal dan mendaftarkan cluster ke GKE Hub, lanjutkan ke langkah berikutnya.

 

1 (NEXT) Langkah 2: Instal cert-manager 3 4 5 6 7 8 9