Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dan men-deploy proxy API baru

Setelah Anda mengonfigurasi Google Cloud dan UI hybrid, serta menginstal dan mengonfigurasi Anda siap untuk melihat bagaimana semuanya bekerja bersama-sama.

Bagian ini akan memandu Anda melakukan hal-hal berikut:

Buat proxy API baru di UI Apigee menggunakan Wizard Proxy API
Deploy proxy baru ke cluster Anda dengan UI

1. Membuat proxy API baru menggunakan UI hybrid

Bagian ini menjelaskan cara membuat proxy API baru di UI dengan menggunakan Wizard Proxy API.

Untuk membuat proxy API sederhana menggunakan Wizard Proxy API:

Buka UI Apigee di browser.
Pilih Develop > Proxy API di tampilan utama.
Dari menu drop-down Lingkungan, pilih lingkungan yang Anda inginkan untuk membuat proxy API baru. Bagian ini mengasumsikan nama lingkungan adalah "test". Anda membuat setidaknya satu lingkungan di Langkah 5: Tambahkan lingkungan.
UI hybrid menampilkan daftar proxy API untuk lingkungan tersebut. Jika Anda belum membuat {i>proxy<i}, daftarnya kosong.
Klik +Proxy di kanan atas. Wizard Proxy API dimulai.
Pilih Reverse proxy (paling umum), lalu klik Berikutnya.
Tampilan Detail proxy ditampilkan.
Konfigurasikan proxy Anda dengan setelan berikut:
- Nama Proxy: Masukkan "myproxy". Langkah-langkah yang tersisa di bagian ini mengasumsikan bahwa ini adalah ID proxy Anda.
- Proxy Base Path: Secara otomatis disetel ke "/myproxy". Proxy Base Path adalah bagian dari URL yang digunakan untuk membuat permintaan ke API Anda. Edge menggunakan URL untuk mencocokkan dan mengarahkan permintaan masuk ke proxy API yang tepat.
- (Opsional) Deskripsi: Masukkan deskripsi untuk proxy API baru Anda, seperti sebagai "Menguji Apigee Hybrid dengan proxy sederhana".
- Target (Existing API): Masukkan "https://mocktarget.apigee.net". Ini mendefinisikan URL target yang dipanggil Apigee pada permintaan ke proxy API. Layanan mocktarget memiliki yang dihosting di Apigee dan menampilkan data sederhana. Pengujian ini tidak memerlukan kunci API atau token akses.
Detail proxy API Anda akan terlihat seperti berikut:
Klik Next.
Pada layar Kebijakan, pilih Lewati (tanpa otorisasi) sebagai keamanan.
Klik Next.
Di layar Ringkasan, klik Buat.
Hybrid menghasilkan proxy (terkadang disebut sebagai paket proxy):

CATATAN: Dalam hal ini, UI campuran tidak men-deploy proxy ke cluster Anda. Anda akan melakukannya di langkah berikutnya.
Klik Buka daftar proxy.
Hybrid menampilkan tampilan Proxy, yang menampilkan daftar proxy API. Tujuan {i>proxy<i} baru harus berada di bagian atas daftar, dengan indikator status abu-abu, artinya ada belum di-deploy.

2. Men-deploy proxy ke cluster menggunakan UI hybrid

Setelah membuat proxy baru, Anda harus men-deploy-nya agar dapat mencobanya. Bagian ini menjelaskan cara men-deploy proxy baru menggunakan UI hybrid.

Untuk men-deploy proxy API di UI hybrid:

Di UI hybrid, pilih Develop > Proxy API.
Pastikan "pengujian" lingkungan dipilih.

UI akan menampilkan proxy baru Anda dalam daftar proxy:
Klik "myproxy" {i>proxy<i}.

UI menampilkan tab Ringkasan Proxy API untuk proxy tersebut.

Perhatikan bahwa di bagian Deployment, kolom Revisi menampilkan "Tidak di-deploy".
Di kolom Revisi, luaskan pemilih drop-down untuk memilih revisi yang akan di-deploy.
Daftar drop-down hanya menampilkan "1" dan "Batalkan deployment".
Pilih "1"—revisi yang ingin Anda deploy—dari menu drop-down.

UI akan meminta Anda untuk mengonfirmasi deployment:
Klik Deploy.
UI memulai proses men-deploy revisi 1 dari proxy baru Anda ke cluster.

Perlu diperhatikan bahwa deployment bukan proses yang instan. Hybrid "akhirnya konsisten" berarti model deployment baru akan diluncurkan ke cluster dalam waktu singkat periode waktu tertentu dan tidak secara langsung.

Meskipun ada beberapa cara untuk memeriksa status deployment proxy di UI, dua langkah berikutnya menjelaskan cara memanggil proxy API yang baru saja Anda deploy dan bagaimana untuk memeriksa status deployment dengan panggilan ke Apigee API.

3. Memanggil proxy API

Ikuti langkah-langkah di bawah ini, tergantung apakah Anda dapat memperbarui data DNS dari nama {i>host<i} yang Anda yang digunakan untuk membuat grup lingkungan.

Jika Anda tidak dapat memperbarui DNS nama {i>host<i}

Ikuti langkah-langkah ini jika nama host grup lingkungan Anda tidak terdaftar atau Anda tidak dapat untuk memperbarui catatan DNS-nya. Pada langkah-langkah ini, Anda akan mendapatkan IP masuk dan menggunakannya langsung dalam panggilan cURL dengan tanda --resolve:

Ekspor IP masuk:

export INGRESS_IP=$(kubectl -n istio-system get service \
  istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

Ekspor nomor port masuk yang aman:

export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \
  service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')

Ekspor alias host grup lingkungan Anda ke variabel:
```
export HOSTALIAS=your_host_alias
```

Memanggil proxy API. Flag --resolve di cURL memungkinkan Anda untuk langsung tentukan IP masuk:

curl  -H Host:$HOSTALIAS --resolve \
  $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_IP  \
  https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k

Jika Anda dapat memperbarui DNS nama {i>host<i}

Ikuti langkah-langkah ini jika nama host yang Anda gunakan saat membuat grup lingkungan terdaftar dan Anda dapat memperbarui data DNS-nya agar mengarah ke IP masuk eksternal:

Ekspor IP eksternal traffic masuk ke variabel:

export INGRESS_IP=$(kubectl -n istio-system get service \
  istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

Periksa apakah variabel menyimpan alamat IP. Contoh:
```
echo $INGRESS_IP
34.118.196.202
```
Gunakan alamat IP ini untuk memperbarui data DNS (biasanya data A atau CNAME) di registrar atau penyedia DNS. Anda mungkin harus menunggu hingga satu jam sampai perubahan data DNS diterapkan.
Ekspor alias host grup lingkungan Anda ke variabel:
```
export HOSTALIAS=your_host_alias
```

Panggil proxy API:

curl -k https://$HOSTALIAS/myproxy

Contoh:

curl -v -k https://apitest.acme.com/myproxy

Jika panggilan berhasil, Anda akan melihat output berikut:

Hello, Guest!