Langkah 8: Promosikan 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 Anda.

  1. Ikuti langkah-langkah di bagian Membuat lingkungan untuk melakukan tindakan 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 Instances lampiran API.

      Perintah ini memicu operasi yang berjalan lama. Pastikan lingkungan telah ditambahkan 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 lampiran API.

      Dengan menambahkan lingkungan ke grup, proxy di lingkungan tersebut akan dapat dirutekan melalui nama host di grup. Tindakan ini akan memicu operasi yang berjalan lama dan 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 mengarahkan kursor ke folder lingkungan

      Wizard Buat lingkungan akan terbuka.

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

      Lingkungan dibuat.

    3. Luaskan folder lingkungan prod di bagian Apigee untuk melihat isinya.
    4. Posisikan kursor Anda di atas file deployments.json di bagian Apigee, lalu klik Ikon Konfigurasi.

      Wizard Deployment akan terbuka.

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

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

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. Deploy arsip konfigurasi proxy API Anda ke lingkungan prod di organisasi Apigee Anda.
    1. Pada 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 pada 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 disetel ke FINISHED yang menunjukkan bahwa depoloyment arsip 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.