Langkah 1: Buat cluster

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

   Versi yang didukung:

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

   Versi yang tidak didukung:

• 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 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 di 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: Membuat 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, 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 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. Perhatikan bahwa, misalnya, us-west1 adalah nama region yang valid, sedangkan us-west1-a adalah zona di region tersebut. Untuk sebagian besar penginstalan campuran, gunakan nama region untuk variabel CLUSTER_LOCATION.
• ORG_NAME: Nama organisasi Anda. ID ini harus cocok dengan project ID 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 campuran 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 region)	3 (per region)
   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 campuran 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 memilih untuk membuat cluster zona, pastikan untuk menggunakan zona tempat petunjuk meminta lokasi Anda di 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 dalam kumpulan
   apigee-runtime	Node pool stateless.	3	4	4/jumlah node dalam kumpulan

   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 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 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 diinstal dan berjalan, 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 region)	3 (per region)
     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 campuran 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster pengguna:
   • Membuat cluster pengguna (panduan memulai) dalam dokumentasi GKE on-premise.

Setelah cluster diinstal dan berjalan, lanjutkan ke langkah berikutnya.

Anthos on bare metal

Persyaratan dan prasyarat

Cluster Anthos on 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 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 region)	3 (per region)
     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 campuran versi 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut dalam dokumentasi cluster Anthos on bare metal untuk membuat cluster pengguna:
   • Membuat cluster: ringkasan.
   • Panduan memulai cluster Anthos on bare metal dalam dokumentasi cluster Anthos on bare metal.

Setelah cluster diinstal dan berjalan, 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 region)	3 (per region)
     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 kumpulan 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 region)	3 (per region)
     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 cluster diinstal dan berjalan, lanjutkan ke langkah berikutnya.

GKE on 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 region)	3 (per region)
     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 campuran versi 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk membuat cluster pengguna:
   • Dokumentasi ringkasan GKE di AWS.
   • Ringkasan penginstalan cluster Anthos di AWS.

Setelah cluster diinstal dan berjalan, 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 region)	3 (per region)
     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 campuran 1.6.9 ini:
   • Apigee Hybrid: platform yang didukung
3. Gunakan petunjuk berikut untuk menginstal Apigee di cluster pengguna OpenShift dan mendaftarkannya dengan GKE Hub.
   Jika Anda tidak 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 oc CLI. Lihat Memulai OpenShift CLI di dokumentasi OpenShift.
   2. Mendaftar 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 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 cluster diinstal dan terdaftar dengan GKE Hub, lanjutkan ke langkah berikutnya.

 

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