Langkah 1: Buat cluster

Saat ini Anda melihat versi 1.6 dokumentasi Hybrid Apigee. Versi ini akan segera berakhir. Anda harus mengupgradenya ke versi yang lebih baru. Untuk informasi selengkapnya, lihat Versi yang didukung.

Version 1.6 (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 versi 1.6.9, 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 $CLUSTER_LOCATION
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 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 Anda untuk menggunakan nama region, bukan nama zona. Region adalah lokasi geografis spesifik tempat Anda dapat menghosting resource Anda. Region dapat memiliki beberapa zona. Misalnya, region us-west1 menunjukkan wilayah di pantai 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 dalam region tersebut. Untuk sebagian besar penginstalan hybrid, gunakan nama region untuk variabel CLUSTER_LOCATION.
• ORG_NAME: Nama organisasi Anda. ID ini harus cocok dengan ID project Google Cloud Anda. Lihat Panduan memulai Hybrid - 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

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	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

2. Periksa versi GKE yang didukung oleh versi hybrid versi 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 memilih untuk membuat cluster zona, pastikan Anda menggunakan zona tempat petunjuk meminta lokasi Anda pada langkah-langkah berikutnya.
     Tips: Jika Anda tidak membuat cluster di jaringan default, ikuti petunjuk dalam Membuat cluster di subnet yang ada
4. Buat minimal dua kumpulan node untuk cluster Anda. Persyaratan kumpulan node minimum adalah:

   Nama kumpulan node default	Deskripsi	Node minimum	CPU minimum per kumpulan node	CPU minimum per node
   apigee-data	Kumpulan node stateful.	3	4	4/jumlah node dalam kumpulan
   apigee-runtime	Kumpulan node stateless.	3	4	4/jumlah node dalam kumpulan

   Ikuti petunjuk di Menambahkan dan mengelola node pool.

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

5. Setelah cluster dibuat, aktifkan workload identity pada cluster dengan perintah berikut:

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

   Untuk informasi selengkapnya, baca artikel Mengaktifkan Workload Identity di cluster

   Catatan: Jika Anda membuat cluster zona, bukan cluster regional, gunakan argumen --zone, bukan --region, seperti dalam 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 cluster terinstal dan berjalan, lanjutkan ke langkah berikutnya.

GKE on prem

Membuat cluster

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

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

Setelah cluster terinstal dan berjalan, lanjutkan ke langkah berikutnya.

Anthos on bare metal

Persyaratan dan prasyarat

Cluster Anthos di bare metal memungkinkan Anda menjalankan cluster Kubernetes langsung di resource mesin Anda sendiri.

Tinjau persyaratan dan prasyarat berikut:

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

Membuat cluster

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

2. Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut di cluster Anthos pada dokumentasi bare metal untuk membuat cluster pengguna:
   • Membuat cluster: ringkasan.
   • Cluster Anthos pada panduan memulai bare metal di dokumentasi bare metal di cluster Anthos.

Setelah cluster terinstal dan berjalan, lanjutkan ke langkah berikutnya.

AKS

Buat cluster AKS

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

2. Periksa versi AKS yang didukung oleh versi hybrid versi 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan salah satu dari kumpulan petunjuk berikut untuk membuat cluster:
   • Menggunakan Azure CLI: Panduan memulai: Deploy cluster Layanan Azure Kubernetes menggunakan Azure CLI.
   • Menggunakan Portal Azure: Panduan memulai: Deploy cluster Azure Kubernetes Service (AKS) menggunakan portal Azure.

EKS

Membuat cluster

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

2. Periksa versi EKS yang didukung oleh versi hybrid versi 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 cluster terinstal dan berjalan, lanjutkan ke langkah berikutnya.

GKE on AWS

Membuat cluster

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

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

Setelah cluster terinstal dan berjalan, lanjutkan ke langkah berikutnya.

OpenShift

Membuat cluster

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

     Konfigurasi	Kumpulan node stateful	Kumpulan node 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 detail selengkapnya tentang konfigurasi cluster minimum, lihat: Konfigurasi cluster minimum

   • Buat minimal dua kumpulan node:

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

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

2. Periksa versi GKE yang didukung oleh versi hybrid versi 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. Menginstal dan mengonfigurasi alat CLI oc. Lihat Mulai menggunakan OpenShift CLI dalam dokumentasi OpenShift.
   2. Daftar ke 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 keterangan:

         • 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 tempat gcloud mendaftarkan cluster. CONTEXT harus 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 Anda menginstal cluster dan terdaftar di GKE Hub, lanjutkan ke langkah berikutnya.

 

Langkah berikutnya

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