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 petunjuk tentang cara merender modul UI di ruang kerja agen, lihat halaman tutorial LivePerson utama. Server aplikasi dan server proxy diperlukan sebelum Anda dapat merender modul di LivePerson.

Meskipun Anda dapat menyiapkan deployment integrasi ini 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 memberikan variabel ini saat Anda membuat aplikasi Conversational Cloud, dan Anda akan memperbaruinya pada saat itu. Anda juga akan melewatkan APPLICATION_SERVER_URL dan DF_PROXY_SERVER_URL pada awalnya. Masing-masing dari dua variabel ini akan ditetapkan setelah aplikasi dan server proxy di-deploy serta menampilkan nilai URL yang diperlukan.

  • LP_ACCOUNT_ID: ID akun LivePerson.
  • LP_CLIENT_ID: Client ID LivePerson Anda. Ini akan disediakan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi disediakan).
  • LP_CLIENT_SECRET: Rahasia klien LivePerson Anda. Ini akan disediakan oleh LivePerson setelah aplikasi Conversational Cloud diinstal. (Lewati variabel ini untuk saat ini, Anda akan memperbaruinya setelah informasi disediakan).
  • 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 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 project ID tidak cocok, jalankan gcloud config set project PROJECT-ID, ganti 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 benar. 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, lalu tetapkan peran Dialogflow Client API.

Mengaktifkan API yang diperlukan

  1. Buka project Google Cloud Platform yang diinginkan.
  2. Klik menu navigasi di konsol Google Cloud Platform, lalu pilih Billing. 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 dalam 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 untuk ditayangkan 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.

Menonaktifkan 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