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 sebelumnya di-deploy.
  • Setelah di-un-deploy, tidak ada revisi proxy API yang di-deploy di lingkungan.

Membatalkan deployment proxy API mirip dengan menghapus proxy API, kecuali bahwa saat membatalkan deployment revisi, Anda dapat memilih untuk mengeditnya di UI dan men-deploy-nya kembali nanti. Jika Anda menghapus proxy API, proxy tersebut tidak lagi tersedia untuk 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 Overview proxy API.

    Proxy dalam tampilan Ringkasan.

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

    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 yang ditampilkan 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 Overview proxy API.

  4. Di baris lingkungan yang diinginkan, luaskan menu drop-down Revisi, lalu pilih Batalkan deployment:

    Drop-down revisi untuk lingkungan produksi yang menampilkan item Batal deployment

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

    Dialog yang meminta konfirmasi tindakan batal deployment

  5. Klik Batalkan deployment.

    UI memperbarui status untuk menunjukkan bahwa revisi telah segera di-un-deploy dari cluster:

    Menu drop-down yang menunjukkan bahwa proxy API tidak di-deploy dari lingkungan pengujian

    Namun, perhatikan bahwa proses pembatalan deployment dapat memerlukan waktu beberapa saat (dalam model konsistensi pada akhirnya). Faktanya, saat Anda mengklik Undeploy, Apigee memulai proses 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 Revisi, 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 operasi penghapusan deployment proxy API

  3. Klik tombol Batalkan deployment.

    UI memperbarui status untuk menunjukkan bahwa revisi segera di-un-deploy. Namun, proses penghapusan deployment dapat memerlukan waktu beberapa saat (dalam model konsisten pada akhirnya). Saat Anda mengklik Batalkan deployment, Apigee akan memulai proses pembatalan 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 mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk mengetahui deskripsi variabel lingkungan yang dapat Anda gunakan, lihat Menetapkan variabel lingkungan untuk permintaan API Apigee.

Berikut adalah contoh output respons (respons kosong):

{}

Untuk mengetahui informasi selengkapnya, lihat Undeploy API proxy revision API.

gcloud

Bagian berikut memberikan contoh penggunaan perintah CLI gcloud alpha apigee untuk membatalkan deployment revisi proxy API dan memvalidasi pembatalan deployment.

Untuk mengetahui informasi selengkapnya dan deskripsi variabel lingkungan yang digunakan dalam contoh, lihat Mulai menggunakan 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 respons: 

Using Apigee organization `my-org`

Memvalidasi pembatalan deployment revisi proxy API menggunakan gcloud CLI

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

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

Berikut adalah contoh respons: 

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

Untuk mengetahui informasi selengkapnya, lihat CLI daftar deployment.