Langkah 8: Mempromosikan arsip ke produksi

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Pada langkah ini, Anda akan mempromosikan arsip konfigurasi proxy API ke lingkungan produksi di organisasi Apigee.

  1. Ikuti langkah-langkah di Membuat lingkungan untuk melakukan hal berikut:
    1. Buat lingkungan prod baru di organisasi Apigee Anda, dengan mengaktifkan Archive sebagai jenis deployment. Gunakan UI atau API.

      Contoh:

      Dialog lingkungan baru yang menampilkan setelan jenis deployment Arsip

    2. Lampirkan lingkungan ke instance runtime menggunakan API lampiran Instance.

      Perintah ini memicu operasi yang berjalan lama. Pastikan lingkungan telah dilampirkan ke runtime sebelum melanjutkan.

    3. Buat grup lingkungan jika Anda belum memilikinya menggunakan Create environment groups API.

      Pastikan grup lingkungan telah dibuat sebelum melanjutkan. Anda dapat memeriksa status grup baru menggunakan permintaan seperti berikut:

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Lampirkan lingkungan baru ke grup lingkungan menggunakan Environment group attachment API.

      Dengan melampirkan lingkungan ke grup, proxy di lingkungan tersebut dapat dirutekan melalui nama host dalam grup. Tindakan ini akan memicu operasi yang berjalan lama yang dapat memerlukan waktu beberapa menit untuk diselesaikan. Sebaiknya tunggu satu atau dua menit sebelum melanjutkan ke langkah berikutnya. Sementara itu, Anda dapat memeriksa status operasi seperti sebelumnya.

  2. Buat lingkungan prod baru di lingkungan pengembangan lokal Anda:
    1. Di Apigee di VS Code, posisikan kursor di atas folder environments di bagian Apigee, lalu klik Buat ikon.

      + ditampilkan saat Anda memosisikan kursor ke folder lingkungan

      Wizard Create environment akan terbuka.

    2. Masukkan prod untuk nama lingkungan, lalu tekan Enter.

      Lingkungan dibuat.

    3. Luaskan folder lingkungan prod di bagian Apigee untuk melihat kontennya.
    4. Arahkan kursor ke file deployments.json di bagian Apigee, lalu klik Ikon konfigurasi.

      Wizard Deployments akan terbuka.

    5. Pilih proxy API helloworld untuk menambahkannya ke deployment, lalu klik OK.

      File deployments.json dibuka di editor. File telah diperbarui untuk menyertakan proxy API helloworld dalam array deployment proxies, seperti yang ditunjukkan di bawah:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. Deploy arsip konfigurasi proxy API Anda ke lingkungan prod di organisasi Apigee Anda.
    1. Di tab Terminal di Apigee VS Code, buka direktori myapigeeworkspace.
      cd myapigeeworkspace
    2. Jalankan perintah berikut:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      Berikut adalah contoh responsnya:

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. Jalankan perintah berikut untuk memeriksa status operasi, dengan mengganti $OPERATION_ID dengan ID operasi yang ditampilkan dalam panggilan sebelumnya:
      gcloud beta apigee operations describe $OPERATION_ID

      Berikut adalah contoh responsnya. Perhatikan bahwa state ditetapkan ke IN_PROGRESS.

      Using Apigee organization 'prod'
      done: true
      metadata:
        '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
        operationType: INSERT
        state: IN_PROGRESS
        targetResourceName: uri
      name: organizations/prod/operations/$OPERATION_ID
      organization: prod
      response:
        '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
        control: 1-5-0-20210319-071117-ghq74
        endTime: '2021-03-20T06:15:44.329363950Z'
        metricLabels:
          env: test
          location: us-central1
        name: uri
        startTime: '2021-03-20T06:14:44.306534584Z'
        treatment: 1-5-0-20210319-190954-if0wk
        verdict: NONE
      uuid: $OPERATION_ID
    4. Ulangi langkah sebelumnya hingga state ditetapkan ke FINISHED yang menunjukkan bahwa deployment arsip telah selesai.
    5. Jalankan perintah berikut untuk melihat semua deployment arsip di lingkungan prod:
      gcloud beta apigee archives list --environment=prod

      Berikut adalah contoh responsnya:

      Using Apigee organization 'prod'
      ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
      vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

Selamat! Anda telah berhasil mempromosikan arsip API ke lingkungan produksi Apigee.