Men-deploy server aplikasi

Panduan ini menguraikan langkah-langkah yang diperlukan untuk menyiapkan server aplikasi yang dapat Anda gunakan untuk merender saran Agent Assist di LivePerson. Server aplikasi digunakan dengan server proxy di direktori yang sama. Untuk mengetahui petunjuk tentang cara merender modul UI di ruang kerja agen, lihat halaman tutorial utama LivePerson. Server aplikasi dan server proxy diperlukan sebelum Anda dapat merender modul di LivePerson.

Meskipun deployment integrasi ini dapat disiapkan di platform hosting mana pun, petunjuk ini menggunakan Cloud Run Google.

Konfigurasi

Saat men-deploy layanan, Anda harus menentukan variabel lingkungan berikut. Pastikan untuk mengosongkan variabel LP_CLIENT_ID dan LP_CLIENT_SECRET saat Anda pertama kali membuat server aplikasi. LivePerson akan menyediakan variabel ini saat Anda membuat aplikasi Conversational Cloud, dan Anda akan memperbaruinya pada saat itu. Anda juga akan melewati APPLICATION_SERVER_URL dan DF_PROXY_SERVER_URL pada awalnya. Setiap variabel ini akan ditetapkan setelah server aplikasi dan proxy di-deploy dan menampilkan nilai URL yang diperlukan.

  • LP_ACCOUNT_ID: ID akun LivePerson.
  • LP_CLIENT_ID: ID klien LivePerson Anda. Kunci ini akan diberikan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi diberikan).
  • LP_CLIENT_SECRET: Rahasia klien LivePerson Anda. ID ini akan diberikan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi diberikan).
  • LP_SENTINEL_DOMAIN: Buka https://developers.liveperson.com/domain-api.html. Masukkan nomor akun Anda dan cari domain untuk "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Buka https://developers.liveperson.com/domain-api.html. Masukkan nomor akun Anda dan cari domain untuk "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL server aplikasi UI. (Lewati untuk saat ini, dan perbarui setelah server aplikasi di-deploy dan Anda mengetahui URL-nya).
  • DF_PROXY_SERVER_URL: URL server proxy. (Lewati untuk saat ini, dan perbarui setelah server proxy di-deploy dan Anda mengetahui URL-nya.)
  • PROJECT_ID: ID project Google Cloud Anda. Jangan sertakan awalan projects/.

Contoh file .env:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

Deploy

Server aplikasi UI harus di-deploy ke layanan hosting Google Cloud. Sebaiknya gunakan Google App Engine atau Cloud Run. Langkah-langkah di bawah menggunakan Cloud Run sebagai contoh.

Menyiapkan gcloud CLI

Proses deployment yang diuraikan dalam tutorial ini menggunakan perintah gcloud CLI. Ikuti langkah-langkah di bawah untuk menyiapkan gcloud CLI secara lokal untuk deployment ini:

  1. Di halaman dokumentasi gcloud CLI, pilih OS Anda dan ikuti petunjuk penginstalan.
  2. Jalankan gcloud config get-value project untuk memeriksa konfigurasi project Google Cloud Platform.
  3. Buka setelan agen Dialogflow Anda dan periksa Project ID yang terkait dengan agen. Project Google Cloud Platform yang dikonfigurasi di gcloud CLI harus cocok dengan Project ID agen.
  4. Jika ID project tidak cocok, jalankan gcloud config set project PROJECT-ID, dengan mengganti PROJECT-ID dengan Project ID dari langkah 3.

Menyiapkan akun layanan

Anda harus membuat Akun Layanan di project Google Cloud Platform agar integrasi berfungsi dengan baik. Untuk mengetahui detail selengkapnya, lihat dokumentasi Dialogflow.

Ikuti langkah-langkah berikut untuk membuat akun layanan dan menyiapkan integrasi:

  1. Pilih project Google Cloud Platform yang terkait dengan resource Agent Assist Anda.
  2. Klik menu navigasi di konsol Google Cloud Platform, arahkan kursor ke IAM & admin, lalu klik Service accounts.
  3. Klik + CREATE SERVICE ACCOUNT, isi detailnya, dan tetapkan peran Dialogflow Client API.

Mengaktifkan API yang diperlukan

  1. Buka project Google Cloud Platform yang Anda inginkan.
  2. Klik menu navigasi di Konsol Google Cloud Platform, lalu pilih Penagihan. Pastikan penagihan diaktifkan untuk project Anda.
  3. Aktifkan Cloud Build dan Cloud Run API untuk project ini.
  4. Clone repositori git berikut ke komputer lokal atau lingkungan pengembangan Anda: git clone [repository url].
  5. Buka direktori root repositori di komputer lokal atau lingkungan pengembangan Anda.

Men-deploy menggunakan CLI

Di terminal lokal, ubah direktori aktif ke direktori root repositori.

Jalankan perintah berikut untuk menyimpan status repositori Anda ke Google Cloud Platform Container Registry. Ganti PROJECT-ID dengan project ID Google Cloud Platform Anda.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

Deploy integrasi Anda ke live menggunakan perintah berikut. Ganti PROJECT-ID dengan project ID Google Cloud Platform agen Anda, dan SERVICE-ACCOUNT-EMAIL dengan email klien akun layanan Anda.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Saat diminta untuk memasukkan region, pilih region (misalnya, us-central1).
  • Saat diminta memasukkan nama layanan, tekan enter untuk menerima nama default.
  • Saat diminta untuk mengizinkan pemanggilan yang tidak diautentikasi, tekan y.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi Cloud Run. Anda dapat melihat daftar deployment integrasi aktif di bagian Cloud Run di Konsol Google Cloud Platform.

Variabel lingkungan

Ikuti petunjuk Cloud Run untuk menetapkan variabel lingkungan yang diperlukan.

Setelah layanan di-deploy, CLI akan menampilkan URL tempat aplikasi di-deploy (target_url). Kembali dan tetapkan variabel lingkungan APPLICATION_SERVER_URL menggunakan nilai ini.

Nonaktifkan server aplikasi

Untuk mematikan server aplikasi, Anda harus menghapus layanan Cloud Run.

Di terminal lokal, jalankan perintah berikut dan pilih platform target yang sebelumnya dipilih untuk mencantumkan deployment aktif:

    gcloud beta run services list

Selanjutnya, jalankan perintah berikut:

   gcloud beta run services delete agent-assist-modules-application-server