Membatalkan deployment proxy API

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Batalkan deployment revisi proxy API dari cluster Anda seperti yang dijelaskan di bagian berikut.

Perhatikan bahwa saat Anda membatalkan deployment revisi:

  • Apigee tidak melakukan roll back revisi ke revisi yang di-deploy sebelumnya.
  • Setelah di-undeploy, tidak ada revisi proxy API yang di-deploy di lingkungan.

Membatalkan deployment proxy API mirip dengan menghapus proxy API, kecuali saat membatalkan deployment revisi, Anda dapat memilih untuk mengeditnya di UI, lalu men-deploy ulang. Jika Anda menghapus proxy API, proxy tersebut tidak lagi dapat diedit.

Editor Proxy Baru

Untuk membatalkan deployment proxy API menggunakan UI:

  1. Jika Anda menggunakan UI Apigee di konsol Cloud: Pilih Proxy development > API Proxies.

    Jika Anda menggunakan UI Apigee klasik: Pilih Develop > API Proxies dan di panel Proxies, pilih lingkungan untuk proxy.

  2. Pilih proxy API yang ingin Anda batalkan deployment-nya. UI menampilkan tampilan Ringkasan proxy API.

    Proxy di tampilan Ringkasan.

  3. Arahkan kursor ke ikon di kolom Status, lalu pilih Undeploy:

    Membatalkan deployment proxy.

Editor Proxy Klasik

Untuk membatalkan deployment proxy API menggunakan UI:

  1. Login ke UI Apigee.
  2. Pilih Develop > API Proxies.

    UI menampilkan daftar proxy API saat ini untuk lingkungan yang dipilih:

    Daftar proxy API ditampilkan yang mencakup
      nama, status, traffic selama 24 jam, penulis, dan waktu terakhir diubah.

  3. Pilih proxy API yang ingin Anda batalkan deployment-nya.

    UI menampilkan tampilan Ringkasan proxy API.

  4. Di baris lingkungan yang diinginkan, luaskan menu drop-down Revision dan pilih Undeploy:

    Drop-down revisi untuk lingkungan produksi yang menampilkan item Undeploy

    UI akan meminta Anda untuk mengonfirmasi versi yang ingin dibatalkan deployment-nya:

    Dialog yang meminta konfirmasi tindakan penghapusan deployment

  5. Klik Batalkan deployment.

    UI akan memperbarui status untuk menunjukkan bahwa revisi segera di-undeploy dari cluster:

    Drop-down yang menampilkan proxy API tidak di-deploy dari lingkungan pengujian

    Namun, perlu diperhatikan bahwa proses pembatalan deployment dapat memerlukan waktu beberapa saat (dalam model akhirnya konsisten). Bahkan, saat Anda mengklik Undeploy, Apigee memulai proses untuk membatalkan deployment revisi yang dipilih dari lingkungan tersebut di cluster.

    Untuk mengetahui informasi tentang cara memeriksa status proxy yang tidak di-deploy, lihat Melihat status deployment.

Atau, Anda dapat membatalkan deployment revisi saat ini yang sedang Anda edit di tab Develop:

  1. Klik menu drop-down Deploy to: env_name:

    Drop-down deployment yang memungkinkan Anda men-deploy atau membatalkan deployment revisi saat ini ke setiap lingkungan

    UI menampilkan daftar lingkungan. Di kolom Revision, UI mencantumkan revisi yang saat ini di-deploy (atau &emdash; jika tidak ada), dan meminta Anda dengan tombol Deploy revision dan Undeploy.

  2. Klik tombol Undeploy untuk lingkungan yang diinginkan.

    UI akan meminta Anda untuk mengonfirmasi versi yang ingin dibatalkan deployment-nya:

    Dialog yang meminta konfirmasi untuk operasi penghapusan deployment proxy API

  3. Klik tombol Batalkan deployment.

    UI akan memperbarui status untuk menunjukkan bahwa revisi segera di-undeploy. Namun, proses penghapusan deployment dapat memerlukan waktu beberapa saat (dalam model eventually consistent). Saat Anda mengklik Undeploy, Apigee akan memulai proses untuk membatalkan deployment revisi yang dipilih dari lingkungan tersebut.

Apigee API

Untuk membatalkan deployment proxy API, gunakan panggilan API berikut:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X DELETE \
  -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 output respons (respons kosong):

{}

Untuk informasi selengkapnya, lihat Undeploy API proxy revision API.

gcloud

Bagian berikut memberikan contoh penggunaan perintah CLI gcloud alpha apigee untuk men-undeploy revisi proxy API dan memvalidasi undeployment.

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

Membatalkan deployment revisi proxy API menggunakan gcloud CLI

Untuk membatalkan deployment revisi proxy API, gunakan perintah gcloud berikut:

gcloud alpha apigee apis undeploy $REV --api=$API --environment=$ENV

Berikut adalah contoh responsnya:

Using Apigee organization `my-org`

Memvalidasi penghapusan deployment revisi proxy API menggunakan gcloud CLI

Untuk memvalidasi bahwa revisi proxy API telah di-undeploy dari lingkungan, gunakan perintah gcloud berikut:

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

Berikut adalah contoh responsnya:

Using Apigee organization `my-org`
Listed 0 items.

Untuk mengetahui informasi selengkapnya, lihat CLI daftar deployment.