Ringkasan deployment

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Catatan: Untuk men-deploy proxy API di lingkungan yang diaktifkan untuk deployment arsip, lihat Men-deploy dan mengelola arsip di lingkungan Apigee.

Saat melakukan perubahan pada proxy API, Anda dapat menyimpannya sebagai revisi baru dan men-deploy-nya ke cluster.

Mulai Cepat:

• Men-deploy proxy API
• Membatalkan deployment proxy API

Tentang deployment

Siklus proses deployment revisi proxy API di Apigee ditampilkan dalam gambar berikut.

Catatan: Di Apigee, MP bertindak secara independen satu sama lain dan MP tertentu dapat berada dalam status yang berbeda dengan MP lainnya (seperti aktif atau nonaktif). Ini dikenal sebagai model deployment yang yang pada akhirnya konsisten untuk proxy API.

Batasan revisi proxy API

Batasan berikut berlaku untuk revisi proxy API:

• Jika membuat perubahan pada proxy API, Anda harus men-deploy-nya sebagai revisi baru.
• Setelah Anda men-deploy proxy API, revisi tersebut akan bersifat hanya baca. Anda tidak dapat mengubah revisi proxy API (misalnya untuk membuat perubahan inkremental); satu-satunya cara untuk mengubah revisi adalah dengan membuat revisi baru dan men-deploy-nya.
• Anggota parlemen hanya dapat men-deploy paket proxy secara keseluruhan. Jika Anda melakukan perubahan pada setiap fragmen atau kebijakan, MP akan tetap men-deploy seluruh paket proxy.
• Jika penggunaan Apigee Anda membedakan antara Proxy Standard dan Extensible proxy, saat men-deploy revisi yang mengubah proxy API dari proxy Standar menjadi Extensible proxy:
  • mungkin timbul biaya. Jika Anda adalah pelanggan Bayar sesuai penggunaan, lihat Hak bayar sesuai penggunaan. Jika Anda adalah pelanggan Langganan, lihat detail paket Anda.
  • deployment tersebut memerlukan waktu tambahan. Selama periode deployment, alur panggilan API tidak terganggu, tetapi Anda tidak dapat men-deploy, membatalkan deployment, atau menghapus proxy. Selain itu, revisi saat ini atau revisi baru tidak dapat dihapus selama periode deployment. Perubahan pada proxy API dan pembuatan revisi baru diizinkan.

Deployment tanpa periode nonaktif

Semua deployment proxy API yang berhasil ke Apigee, adalah deployment dengan periode nonaktif nol. Deployment proxy API terjadi dalam urutan berikut:

1. Revisi 1 proxy API /hello di-deploy dan menangani traffic.
2. Revisi 2 dari /hello di-deploy.
3. Revisi 2 di-deploy ke Pemroses Pesan pada bidang runtime.
4. Revisi 1 tidak di-deploy.

Deployment revisi proxy API kini telah selesai tanpa periode nonaktif.

Catatan: Jika deployment Revisi 2 gagal karena alasan apa pun, versi sebelumnya, Revisi 1, akan tetap dibatalkan. Dalam hal ini, Anda dapat men-deploy ulang revisi sebelumnya untuk memulihkannya. Kemudian, Anda dapat memperbaiki revisi baru dan men-deploy-nya.

Melihat status deployment

Men-deploy proxy API pada Apigee tidak membuatnya langsung tersedia. Perlu waktu untuk menyinkronkan proxy API di semua MP di bidang runtime. Namun, Apigee menyediakan alat yang dapat memberi Anda beberapa informasi tentang status revisi proxy API Anda.

UI Apigee

Dalam UI Apigee, ada beberapa tampilan yang menyediakan status deployment proxy API Anda.

Tampilan UI Apigee

Langkah & Deskripsi

Proxy

Pilih Develop > API Proxy: UI Apigee menggunakan ikon berikut untuk memberikan status cepat bagi setiap proxy API: Menunjukkan bahwa proxy API belum di-deploy ke lingkungan yang dipilih. Menunjukkan bahwa tidak ada error atau peringatan untuk proxy tersebut di lingkungan yang dipilih. Menunjukkan bahwa beberapa perutean tidak diperbarui karena konflik jalur dasar. Menunjukkan bahwa terjadi error saat men-deploy proxy API. Untuk melihat ikon status, klik tab Develop. Atau, Anda dapat memilih Develop > API Proxies dan mengklik proxy API

API Apigee

Untuk melihat status deployment revisi proxy API Anda di lingkungan tertentu, gunakan panggilan API berikut:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut ini contoh respons. Contoh ini menunjukkan status deployment untuk revisi 1 dari proxy API helloworld yang di-deploy di lingkungan test:

{
  "environment": "test",
  "apiProxy": "helloworld",
  "revision": "1",
  "deployStartTime": "1559149080457",
  "pods": [
    {
      "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w",
      "deploymentStatus": "deployed",
      "statusCodeDetails": "Deployment Success",
      "podStatus": "active",
      "podStatusTime": "1595357668001"
    }
  ],
  "state": "READY"
}

Untuk informasi selengkapnya, lihat API deployment lingkungan revisi proxy API.

gcloud

Untuk melihat status deployment revisi proxy API Anda di lingkungan, gunakan perintah gcloud berikut ini:

gcloud alpha apigee deployments describe --api=$API --environment=$ENV

Untuk mengetahui informasi selengkapnya dan deskripsi variabel lingkungan yang digunakan dalam contoh, lihat Mulai menggunakan gcloud dengan Apigee.

Berikut ini contoh respons. Contoh ini menunjukkan status deployment untuk revisi 1 dari proxy API helloworld yang di-deploy di lingkungan test:

Using Apigee organization `my-org`
Using deployed revision `1`
apiProxy: helloworld
deployStartTime: '1598032332802'
environment: test
pods:
- deploymentStatus: deployed
  podName: apigee-runtime-myorg-test-f8bdf9d-2s72w
  podStatus: active
  podStatusTime: '1598302128087'
  statusCodeDetails: Deployment Success
revision: '1'
state: READY

Untuk mengetahui informasi selengkapnya, lihat Menjelaskan CLI deployment.

Melihat penggunaan deployment proxy

Penggunaan proxy API di organisasi Anda mungkin dikenai kuota deployment, yaitu batas jumlah unit deployment yang dapat Anda gunakan dalam satu waktu. Lihat hak Anda (Pay-as-you-go atau Langganan) untuk mengetahui detailnya. Anda dapat melihat penggunaan deployment proxy organisasi dari beberapa tempat dalam https://console.cloud.google.com/apigee, seperti yang dijelaskan di bawah ini.

Lihat penggunaan deployment di halaman Ringkasan Apigee

Untuk melihat penggunaan deployment proxy API dari halaman Overview Apigee:

1. Buka halaman Overview di UI Apigee di Konsol Google Cloud.

   Buka Ringkasan

2. Anda dapat melihat penggunaan deployment proxy untuk organisasi Anda secara sekilas menggunakan kartu Penggunaan Proxy, yang menampilkan informasi berikut untuk organisasi Anda:
   • Proxy yang di-deploy: Jumlah total revisi proxy API yang di-deploy di organisasi Anda.
   • Unit deployment proxy: Jumlah total revisi proxy API yang di-deploy di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment yang dapat diperluas: Jumlah revisi proxy API yang dapat diperluas yang di-deploy di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment standar: Jumlah revisi proxy API standar yang di-deploy di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
3. Dengan menggunakan kartu Environments di halaman Overview, Anda juga dapat melihat Kuota yang digunakan oleh organisasi Anda.

Melihat penggunaan deployment di halaman Proxy API

Untuk melihat penggunaan deployment proxy API dari halaman API Proxy:

1. Buka halaman API Proxy di UI Apigee di Konsol Google Cloud.

   Buka proxy API

2. Halaman API Proxy menampilkan informasi berikut:
   • Total proxy: Jumlah total proxy API yang dikembangkan di organisasi Anda.
   • Proxy yang di-deploy: Jumlah total revisi proxy API yang di-deploy di semua lingkungan di organisasi Anda.
   • Total unit deployment: Jumlah total revisi proxy API yang di-deploy di semua lingkungan di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment proxy yang dapat diperluas: Jumlah revisi proxy API yang dapat diperluas yang di-deploy di semua lingkungan dalam organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment proxy standar: Jumlah revisi proxy API standar yang di-deploy di semua lingkungan dalam organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.

Lihat penggunaan deployment di halaman Lingkungan

Untuk melihat penggunaan deployment proxy API dari halaman Environments:

1. Buka halaman Environments di UI Apigee di Konsol Google Cloud.

   Buka Lingkungan

2. Pilih tab ringkasan Lingkungan guna menampilkan informasi berikut untuk semua lingkungan:
   • Total unit deployment: Jumlah total revisi proxy API yang di-deploy di semua lingkungan di organisasi Anda.
   • Unit deployment proxy yang dapat diperluas: Jumlah revisi proxy API yang dapat diperluas yang di-deploy di semua lingkungan dalam organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment proxy standar: Jumlah revisi proxy API standar yang di-deploy di semua lingkungan dalam organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Unit deployment alur bersama: Jumlah total revisi alur bersama yang di-deploy di seluruh lingkungan di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Kuota: Jumlah unit deployment yang tersedia untuk organisasi yang digunakan di semua lingkungan di organisasi Anda.
3. Untuk melihat penggunaan deployment proxy untuk lingkungan tunggal:
   1. Dalam daftar Environments, pilih nama lingkungan untuk melihat detailnya.
   2. Pilih tab Deployment untuk melihat penggunaan unit deployment untuk lingkungan yang dipilih.

Langkah berikutnya

Pelajari cara men-deploy: Men-deploy Proxy API

Pelajari cara membatalkan deployment: Membatalkan deployment Proxy API