Ringkasan deployment

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat 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 membuat perubahan pada proxy API, Anda dapat menyimpannya sebagai revisi baru dan men-deploy-nya ke cluster.

Panduan Memulai:

• 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 dari MP lainnya (seperti aktif atau dinonaktifkan). Hal ini dikenal sebagai model deployment konsisten tertunda untuk proxy API.

Batasan revisi proxy API

Batasan berikut berlaku untuk revisi proxy API:

• Jika Anda melakukan perubahan pada proxy API, Anda harus men-deploynya sebagai revisi baru.
• Setelah Anda men-deploy proxy API, revisi tersebut hanya dapat dibaca. Anda tidak dapat mengubah revisi proxy API (seperti untuk membuat perubahan inkremental); satu-satunya cara untuk mengubah revisi adalah dengan membuat revisi baru dan men-deploy-nya.
• MP hanya dapat men-deploy paket proxy secara keseluruhan. Jika Anda membuat perubahan pada setiap fragmen atau kebijakan, MP akan tetap men-deploy seluruh paket proxy.
• Jika penggunaan Apigee Anda membedakan antara proxy Standar dan Extensible, saat men-deploy revisi yang mengubah proxy API dari proxy Standar menjadi proxy Extensible:
  • biaya mungkin akan dikenakan. Jika Anda adalah pelanggan Bayar sesuai pemakaian, lihat Hak istimewa Bayar sesuai pemakaian. Jika Anda adalah pelanggan Langganan, lihat detail paket Anda.
  • deployment 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 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 tanpa periode nonaktif. Deployment proxy API terjadi dalam urutan ini:

1. Revisi 1 proxy API /hello di-deploy dan menangani traffic.
2. Revisi 2 dari /hello di-deploy.
3. Revisi 2 di-deploy ke Message Processor di platform 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, masih belum di-deploy. Dalam hal ini, Anda dapat men-deploy ulang revisi sebelumnya untuk memulihkannya. Kemudian, Anda dapat memperbaiki revisi baru dan men-deploynya.

Melihat status deployment

Men-deploy proxy API di Apigee tidak akan langsung membuatnya tersedia. Perlu waktu agar proxy API disinkronkan di semua MP di platform runtime. Namun, Apigee menyediakan alat yang dapat memberi Anda beberapa informasi tentang status revisi proxy API.

UI Apigee Klasik

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

Tampilan UI Apigee

Langkah-langkah & Deskripsi

Proxy

Pilih Develop > API Proxies: UI Apigee menggunakan ikon berikut untuk memberikan status cepat untuk 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 pemilihan rute tidak diperbarui karena konflik jalur dasar. Menunjukkan bahwa terjadi error saat men-deploy proxy API. Untuk melihat ikon status, klik tab Mengembangkan. Atau, Anda dapat memilih Develop > API Proxies dan mengklik proxy API

Apigee API

Untuk melihat status deployment revisi proxy API Anda di lingkungan, 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 Anda, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut adalah contoh responsnya. Contoh ini menunjukkan status deployment untuk revisi 1 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:

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

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

Berikut adalah contoh responsnya. Contoh ini menunjukkan status deployment untuk revisi 1 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 CLI deskripsi deployment.

Melihat penggunaan deployment proxy

Penggunaan proxy API di organisasi Anda mungkin tunduk pada kuota deployment, yang merupakan 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 UI Apigee di konsol Cloud, seperti yang dijelaskan di bawah.

Catatan: Jika organisasi Anda mengaktifkan Apigee hybrid, hanya sebagian dari metrik penggunaan ini yang ditampilkan.

Melihat penggunaan deployment di halaman Ringkasan Apigee

Untuk melihat penggunaan deployment proxy API dari halaman Ringkasan Apigee:

1. Buka halaman Ringkasan 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:
   • Total proxy yang dibuat: Jumlah total proxy API yang dibuat, termasuk proxy yang di-deploy dan tidak di-deploy.
   • Proxy yang di-deploy: Jumlah total proxy API yang di-deploy di semua lingkungan dalam organisasi.
   • Unit deployment proxy: Jumlah total revisi proxy API atau alur bersama yang di-deploy di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
   • Proxy dan alur bersama yang di-deploy berdasarkan batas: Jumlah total proxy API dan alur bersama yang di-deploy di organisasi, berdasarkan batas untuk jenis organisasi Anda.
   • 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.

Melihat penggunaan deployment di halaman Proxy API

Untuk melihat penggunaan deployment proxy API dari halaman Proxy API:

1. Buka halaman API Proxies di UI Apigee di konsol Google Cloud.

   Buka proxy API

2. Halaman Proxy API menampilkan informasi berikut:
   • Total proxy yang dibuat: Jumlah total proxy API yang dikembangkan di organisasi Anda, termasuk proxy yang di-deploy dan tidak di-deploy.
   • Proxy yang di-deploy: Jumlah total revisi proxy API yang di-deploy di semua lingkungan di organisasi Anda.
   • Unit deployment proxy: Jumlah total revisi proxy API atau alur bersama 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 seluruh lingkungan di 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 di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.

Melihat 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 untuk menampilkan informasi berikut untuk semua lingkungan:
   • Total unit deployment proxy: Jumlah total revisi proxy API atau alur bersama 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 seluruh lingkungan di 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 di 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 semua lingkungan di organisasi Anda. Setiap deployment per lingkungan, per instance, dihitung sebagai satu unit.
3. Untuk melihat penggunaan deployment proxy untuk satu lingkungan:
   1. Dalam daftar Environments, pilih nama lingkungan untuk melihat detailnya.
   2. Pilih tab Deployments 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