Langkah 1: Buat cluster

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.

Membuat cluster

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

Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

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}
```

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

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

Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

Periksa versi AKS yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

Periksa versi EKS yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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

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

Periksa versi GKE yang didukung oleh versi hybrid versi 1.6.9 ini:
- Apigee Hybrid: platform yang didukung
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 6 7 8