Menggunakan Apigee Connect (Beta)

Bagian ini menjelaskan penggunaan Apigee Connect (Beta) untuk komunikasi antara pengelolaan hybrid dan layanan MART di bidang runtime.

Pengantar

Apigee Connect memungkinkan bidang pengelolaan hybrid Apigee terhubung dengan aman ke layanan MART di bidang runtime tanpa mengharuskan Anda mengekspos endpoint MART di internet. Jika Anda menggunakan Apigee Connect, Anda tidak perlu mengonfigurasi gateway masuk MART dengan alias host dan atau sertifikat DNS yang diotorisasi.

Layanan utama yang dijalankan di bidang runtime hybrid yang menampilkan Apigee Connect

Prasyarat

Apigee Hybrid versi 1.2.0 atau yang lebih baru harus diinstal dan dikonfigurasi sebelum menyiapkan Apigee Hubungkan.

  • Jika Anda menginstal Apigee Hybrid untuk pertama kalinya, ikuti petunjuk penginstalan di dokumentasi Apigee Hybrid.
  • Jika saat ini menggunakan Apigee Hybrid versi 1.1.x, Anda harus mengupgrade penginstalan ke versi 1.2.0 sebelum melanjutkan. Untuk langkah-langkah peningkatan, lihat Mengupgrade Apigee Hybrid

Menambahkan Apigee Connect ke runtime hybrid

Bagian ini mengasumsikan bahwa Anda telah menginstal atau mengupgrade ke dan mengonfigurasi Apigee hybrid 1.2.0 atau yang lebih baru

Saat Apigee Connect dikonfigurasi dan diaktifkan, traffic masuk MART akan diabaikan: bidang pengelolaan hanya terhubung ke MART menggunakan Apigee Connect. Semua traffic MART di antara penerusan bidang runtime hybrid melalui koneksi Apigee Connect yang aman.

Ikuti langkah-langkah berikut untuk mengaktifkan dan menggunakan Apigee Connect dengan Apigee Hybrid:

  1. Aktifkan Apigee Connect API di Library Google Cloud API. Anda dapat mengaktifkan API di Konsol Google Cloud (GCP) atau dengan gcloud. Untuk mendapatkan petunjuk tentang mengaktifkan API di Konsol Google Cloud, lihat Langkah 3: Aktifkan API. Untuk menggunakan gcloud guna mengaktifkan API:
    $ gcloud config set project YOUR_GCP_PROJECT_ID
    $ gcloud services enable apigeeconnect.googleapis.com

    Dengan YOUR_GCP_PROJECT_ID merupakan project GCP yang sama dengan Apigee diaktifkan dan organisasi Apigee telah disediakan untuk Anda.
  2. Menambahkan peran Apigee Connect Agent ke akun layanan MART yang Anda buat dalam Langkah Buat akun layanan dalam petunjuk penginstalan hybrid Apigee:
    $ gcloud projects add-iam-policy-binding YOUR_GCP_PROJECT_ID
    --member serviceAccount:YOUR_MART_SERVICE_ACCOUNT_EMAIL --role roles/apigeeconnect.Agent

    Dengan YOUR_GCP_PROJECT_ID merupakan project GCP yang sama dengan Apigee diaktifkan dan organisasi Apigee telah disediakan untuk Anda, dan YOUR_MART_SERVICE_ACCOUNT_EMAIL adalah nama akun layanan MART. Nama diberikan dalam bentuk alamat email. Contoh: apigee-mart@my-project..

    Peran Agen Apigee Connect telah ditetapkan sebelumnya dan memiliki izin berikut yang ditetapkan tindakan tersebut:
    Izin Deskripsi
    apigeeconnect.endpoints.connect Ini adalah izin untuk menyiapkan Agen Apigee Connect.

    Untuk mengetahui detail tentang cara menetapkan pemberian izin akses melalui konsol GCP atau API, lihat:

  3. Pastikan file kunci akun layanan MART ada di hybrid_files/service_accounts seperti yang dijelaskan dalam Buat akun layanan.
  4. Buka file penggantian dan tambahkan stanza berikut. Konfigurasi mengharuskan Anda untuk menyediakan jalur ke kunci akun layanan yang didownload. Kunci tersebut harus untuk akun layanan dengan Agen Apigee Connect .
    # Apigee Connect Agent
    connectAgent:
      enabled: true
      serviceAccountPath: ./service-accounts/connect_agent_sa_key.json

    Tambahkan stanza di judul k8sCluster, misalnya:
    k8sCluster:
      name: your_cluster_name
      region: your_cluster_region
    
    # Apigee Connect Agent
    connectAgent:
      enabled: true
      serviceAccountPath: ./service-accounts/connect_agent_sa_key.json
    # Apigee Connect Agent
    connectAgent:
      enabled: true
      replicaCountMin: 3
      serviceAccountPath: ./service-accounts/connect_agent_sa_key.json
  5. Cari kunci akun layanan dengan peran Apigee Organization Admin yang yang Anda download saat awalnya menginstal Apigee Hybrid seperti yang dijelaskan di bagian Aktifkan akses sinkronisasi. Anda memerlukan kunci ini untuk membuat token yang diperlukan untuk melakukan panggilan API sebagai yang dijelaskan di bawah ini.
  6. Jalankan dua perintah berikut untuk mendapatkan token:
    $ export GOOGLE_APPLICATION_CREDENTIALS=org-admin-service-account-file
    $ export TOKEN=$(gcloud auth application-default print-access-token)

    Dengan org-admin-service-account-file adalah jalur di sistem Anda ke layanan kunci akun yang Anda download dengan peran Apigee Organization Admin.
  7. Panggil Apigee API berikut guna mengaktifkan Apigee Connect untuk organisasi Anda:
    curl -v -X PUT \
       https://apigee.googleapis.com/v1/organizations/your_org_name \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $TOKEN" \
      -d '{
      "name" : "your_org_name",
      "properties" : {
        "property" : [ {
          "name" : "features.hybrid.enabled",
          "value" : "true"
        }, {
          "name" : "features.mart.connect.enabled",
          "value" : "true"
        } ]
      }
    }'

  8. Mulai Agen Apigee Connect di cluster:

    $ $APIGEECTL_HOME/apigeectl apply -f your_overrides_file.yaml -c connect-agent

  9. mart:
      hostAlias: "mart.apigee-hybrid-docs.net"
      serviceAccountPath: ./service-accounts/example-project-apigee-mart.json
      sslCertPath: ./certs/fullchain.pem
      sslKeyPath: ./certs/privkey.key
    
  10. Periksa log Agen Apigee Connect. Jika tidak ada error yang dilaporkan, upgrade berhasil:
    $ kubectl logs -n namespace apigee-connect-agent-pod-name

    Agen Apigee Connect melaporkan kategori log berikut:
    Kategori log audit Operasi
    DATA_READ ConnectionService.ListConnections
    DATA_WRITE Tether.Egress
    Untuk mendapatkan bantuan terkait melihat log audit di Apigee Hybrid, lihat Informasi logging audit.
  11. Dengan upgrade ini, bidang runtime hybrid berkomunikasi dengan bidang pengelolaan melalui Apigee Hubungkan.

  12. Uji penginstalan.

Lihat juga: Menghapus Apigee Connect.

Menguji penginstalan

  1. Buka UI Apigee Hybrid.
  2. Pastikan bahwa aplikasi Developer dan Developer yang Anda buat sebelumnya ada di UI. Karena dikueri dari server MART, entitas ini hanya akan ada jika komunikasi antara bidang manajemen dan runtime dikonfigurasi dengan benar.
  3. Untuk memastikan permintaan masuk melalui Apigee Connect dan bukan melalui masuk MART, periksa Log server MART. Anda akan melihat entri untuk agen Apigee Connect bernama apigee-connect-agent-1.0:
    $ kubectl logs -n apigee apigee-mart-orgname-rc101-q72tl -c apigee-mart | grep connect

    Contoh:
    "2019-12-11 04:59:52,321 org: env: target: action: context-id: mode: pool-1-thread-1 INFO MART_AUDITLOG - MartAuditListener.eventOccurred() : Type:Audit edge-gaambo-controlplane@ 1576040392317 /v1/organizations/apigee-connect-hybrid-prod/developers/ count=100&expand=true&startKey=4ee9e8f7-12b2-4cde-bf10-32d991469876 200 GET apigee-connect-hybrid-prod 10.40.11.3 10.40.0.5 apigee-connect-agent-1.0 null"
  4. Di UI hybrid, buat produk API, developer, dan aplikasi developer. Kemudian, periksa MART log layanan untuk memastikan entri log mengonfirmasi bahwa entity telah dikirim ke bidang runtime. Misalnya, entri log berikut menunjukkan bahwa produk API yang disebut foo-product telah diterima:
    $ kubectl logs -n apigee apigee-mart-orgname-rc101-q72tl -c apigee-mart

    2019-12-16 22:15:29,572 org: env: target: action: context-id: mode: pool-1-thread-1 INFO  MART_AUDITLOG - MartAuditListener.eventOccurred() : Type:Audit edge-gaambo-controlplane@ 1576534529566 /v1/organizations/myorg/apiproducts/foo-product/ -NA- 201 CREATE myorg 10.16.1.61  10.16.1.64 apigee-connect-agent-1.0 null
    
    2019-12-16 22:15:30,412 org: env: target: action: context-id: mode: pool-1-thread-1 INFO  MART_AUDITLOG - MartAuditListener.eventOccurred() : Type:Audit edge-gaambo-controlplane@ 1576534530407 /v1/organizations/myorg/apps/ apiProduct=foo-product&expand=false 200 GET myorg 10.16.1.61  10.16.1.64 apigee-connect-agent-1.0 null
  5. Coba buat dan terapkan proxy baru, seperti yang dijelaskan di Membuat dan men-deploy proxy.
  6. Konfigurasikan proxy Anda dengan verifikasi kunci API dengan mengikuti langkah-langkah di Amankan proxy API dengan mewajibkan kunci API. Runtime memperoleh data yang diperlukan untuk memvalidasi Kunci API dari bidang pengelolaan melalui Apigee Connect; oleh karena itu, jika verifikasi kunci API berfungsi, Anda tahu bahwa Apigee Connect berfungsi dengan baik. Anda juga dapat memeriksa log Apigee Connect untuk melihat laporan transfer data.

Menghapus Apigee Connect

Jika Anda menghapus deployment Apigee Connect, status pod dapat tetap berada di "Menghentikan" status untuk hingga tujuh menit. Durasi waktu ini diharapkan. Agen Apigee Connect menunggu koneksi berakhir alih-alih menghentikannya tiba-tiba. Penundaan memastikan bahwa permintaan yang sedang berlangsung tidak hilang.