Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 1: Mengekspos gateway masuk Apigee

Langkah ini menjelaskan cara menyiapkan layanan Kubernetes untuk gateway ingress Apigee Anda. Layanan Kubernetes diperlukan untuk setiap deployment ingress guna mendapatkan alamat IP yang dapat diekspos. Panggilan klien ke proxy akan memanggil nama host yang akan diselesaikan ke alamat IP ini.

Opsi untuk layanan Kubernetes untuk gateway ingress Apigee Anda

Ada dua opsi untuk menyediakan layanan kubernetes guna menetapkan alamat IP ...

Buat layanan Kubernetes kustom untuk setiap gateway ingress Apigee (direkomendasikan).
Gunakan layanan Kubernetes default.

Membuat layanan Kubernetes Anda sendiri

Untuk lingkungan produksi, Apigee merekomendasikan Anda membuat layanan Kubernetes kustom untuk setiap gateway ingress.

Apigee menghapus layanan default, tetapi tidak menghapus layanan Kubernetes kustom saat pembersihan. Oleh karena itu, alamat IP tidak akan dilepaskan saat menginstal ulang Apigee Hybrid.
Untuk platform yang tidak ada di Google Cloud, seperti EKS, AKS, dan OpenShift, Anda perlu menyesuaikan layanan Kubernetes agar berfungsi dengan penyedia cloud. Oleh karena itu, lebih baik membuat layanan Kubernetes kustom daripada menggunakan layanan default, karena Apigee tidak mendukung semua penyesuaian pada layanan Kubernetes default.

Gunakan langkah-langkah berikut untuk menyiapkan dan merutekan traffic ke gateway ingress baru.

Buat layanan Kubernetes dengan label pemilih pod yang diperlukan, app, ingress_name, dan org. Label ini sudah ada di pod gateway ingress Apigee.

Buat file layanan menggunakan template berikut:

apiVersion: v1
kind: Service
metadata:
  name: SERVICE_NAME
  namespace: APIGEE_NAMESPACE
spec:
  ports:
  - name: status-port
    port: 15021
    protocol: TCP
    targetPort: 15021
  - name: https
    port: 443
    protocol: TCP
    targetPort: 8443
  selector:
    app: apigee-ingressgateway #required
    ingress_name: INGRESS_NAME
    org: ORG_NAME
  type: LoadBalancer
  loadBalancerIP: LOAD_BALANCER_IP

SERVICE_NAME adalah nama yang digunakan untuk mengidentifikasi layanan ini. Misalnya, apigee-prod-1.
Catatan: Untuk mengidentifikasi layanan dengan lebih mudah, gunakan nama ingress sebagai bagian dari nama layanan.
INGRESS_NAME adalah nama gateway ingress Apigee ini. Nama ini harus sama dengan nama yang Anda berikan untuk ingressGateways.name dalam file overrides.yaml. Untuk informasi selengkapnya, lihat ingressGateways di Referensi properti konfigurasi.
ORG_NAME adalah nama organisasi Apigee. Nama ini harus sama dengan nama yang Anda berikan untuk org dalam file overrides.yaml. Untuk informasi selengkapnya, lihat org di Referensi properti konfigurasi.
LOAD_BALANCER_IP adalah alamat IP untuk load balancer.
Jika Anda memiliki alamat IP yang dicadangkan untuk load balancer, masukkan alamat tersebut.

Jika Anda belum mencadangkan alamat IP, Anda dapat menggunakan alamat IP yang ditampilkan oleh layanan ingress Apigee default. Gunakan EXTERNAL-IP yang ditampilkan oleh perintah berikut:
```
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
```
Perhatian: Karena batasan pada Load Balancer Aplikasi internal Google Cloud, opsi perutean Apigee ini tidak mendukung permintaan HTTP 1.0. Permintaan klien masuk yang menentukan protokol HTTP 1.0 akan gagal. Versi HTTP yang lebih baru didukung.

Gateway masuk Apigee mengekspos port berikut:

Port	Deskripsi
443	Traffic runtime.
15021	Health check. `status-port` mengekspos endpoint `/healthz/ready` yang dapat digunakan dengan health check GKE Ingress.

Buat layanan dengan menerapkan SERVICE_FILENAME.yaml:
```
kubectl apply -f SERVICE_FILENAME.yaml
```

Temukan IP eksternal gateway ingress Apigee dengan perintah berikut:

kubectl get svc -n APIGEE_NAMESPACE SERVICE_NAME

Output Anda akan terlihat seperti ini:

NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h

Nonaktifkan load balancer untuk layanan gateway ingress Apigee default:
1. Perbarui properti ingressGateways[].svcType ke ClusterIP dalam file penggantian Anda:
```
ingressGateways:
  svcType: ClusterIP
```
2. Upgrade diagram apigee-org untuk menerapkan perubahan:
```
helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f overrides.yaml
```
Lihat Menonaktifkan load balancer untuk layanan gateway ingress Apigee default untuk mengetahui informasi selengkapnya.
Uji gateway masuk dengan melakukan panggilan health check.
```
curl -H 'User-Agent: GoogleHC' https://DOMAIN/healthz/ingress -k \
  --resolve "DOMAIN:443:INGRESS_IP_ADDRESS"
```
Di mana
- DOMAIN adalah domain yang Anda berikan sebagai nama host untuk grup lingkungan yang Anda buat di Penyiapan project dan organisasi - Langkah 3: Buat grup lingkungan.
- INGRESS_IP_ADDRESS adalah alamat IP ingress, misalnya 233.252.0.123.
Jika berhasil, perintah akan menampilkan:
```
Apigee Ingress is healthy
```
Gunakan alamat IP ini untuk memperbarui data DNS Anda (biasanya data A atau CNAME) di registrar atau penyedia DNS Anda.

Menggunakan layanan Kubernetes default

Untuk lingkungan non-produksi atau untuk menguji traffic awal melalui gateway ingress Apigee, Apigee Hybrid menyediakan layanan Kubernetes default untuk setiap deployment ingress.

Anda dapat membuat perubahan konfigurasi terbatas pada layanan default di file overrides.yaml Anda. Untuk opsi konfigurasi yang tersedia, lihat Mengelola gateway ingress Apigee. Misalnya, Anda dapat menambahkan anotasi.

Untuk lingkungan produksi, sebaiknya Anda menyediakan layanan Kubernetes untuk ingress. Ikuti langkah-langkah di Membuat layanan Kubernetes Anda sendiri.

Temukan IP eksternal layanan ingress Apigee default dengan perintah berikut:

kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway