Menginstal dan mengonfigurasi ABAP SDK edisi SAP BTP untuk Google Cloud

Dokumen ini menjelaskan cara menginstal dan mengonfigurasi ABAP SDK edisi SAP BTP untuk Google Cloud di lingkungan SAP BTP, ABAP.

Dokumen ini ditujukan untuk administrator SAP,administrator Google Cloud , dan profesional SAP dan Google Cloud keamanan lainnya.

Ringkasan

ABAP SDK untuk Google Cloud menyediakan library klien dalam bentuk class ABAP agar developer dapat mengakses API Google Cloud secara terprogram. Dengan mengenkapsulasi fungsi penting seperti keamanan, autentikasi, serialisasi dan deserialisasi data, serta penanganan error sebagai komponen yang dapat digunakan kembali, library klien ini mengurangi jumlah kode yang perlu ditulis oleh developer. Untuk mengetahui daftar lengkap library klien yang disediakan ABAP SDK untuk Google Cloud, lihat Library klien ABAP SDK untuk Google Cloud.

Sebagai developer ABAP, Anda dapat mem-build dan men-deploy solusi berbasis ML dan AI menggunakan berbagai layanan Google Cloudseperti Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, Google Workspace API, dan Google Maps Platform.

Mulai versi 1.1, ABAP SDK untuk Google Cloud edisi SAP BTP menawarkan alat khusus, Vertex AI SDK untuk ABAP, untuk interaksi yang lancar dengan platform Vertex AI Google Cloud. Untuk informasi tentang Vertex AI SDK untuk ABAP, lihat Ringkasan Vertex AI SDK untuk ABAP.

Untuk komunikasi antara SAP dan Google Cloud API, ABAP SDK untuk Google Cloud menggunakan protokol HTTPS dengan SSL.

Sebelum memulai

Sebelum menginstal ABAP SDK untuk Google Cloud edisi SAP BTP, lakukan hal berikut:

  1. Berlangganan Portal Lanskap SAP BTP. Untuk informasi tentang cara berlangganan ke portal Lanskap, lihat Berlangganan ke Portal Lanskap di SAP BTP Cockpit.

  2. Anda memiliki ID S-User yang valid yang dikaitkan dengan nomor pelanggan yang memiliki kontrak dukungan SAP aktif.

  3. Jika Anda baru menggunakan Google Cloud, buat akun di https://cloud.google.com.

  4. Jika Anda belum memiliki project Google Cloud, buat project:

    Buka pemilih project

  5. Pastikan penagihan diaktifkan untuk project Anda. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project.

  6. Aktifkan API yang didukung yang ingin Anda akses menggunakan SDK. Untuk mengetahui informasi tentang cara mengaktifkan APIGoogle Cloud , lihat Mengaktifkan API.

Upload sertifikat Google

Untuk mengamankan komunikasi antara lingkungan SAP BTP, ABAP dan server Google, Anda perlu mengupload sertifikat Google yang diperlukan ke aplikasi Maintain Certificate Trust List di lingkungan SAP BTP, ABAP.

Untuk mengupload sertifikat ke aplikasi SAP Maintain Certificate Trust List, Anda harus memiliki akses ke SAP_CORE_BC_SEC katalog bisnis. Katalog bisnis ini disertakan dalam peran bisnis yang telah ditentukan SAP_BR_ADMINISTRATOR.

Untuk mengupload sertifikat Google, lakukan langkah-langkah berikut:

  1. Download sertifikat berikut dari repositori Layanan Kepercayaan Google:

    • GTS Root R1
    • GTS CA 1C3

  2. Login ke SAP BTP Cockpit. Untuk mengetahui informasi selengkapnya, lihat halaman SAP Mengakses Cockpit.

  3. Pilih sub-akun tempat lingkungan ABAP Anda dihosting.

  4. Buka Instance and Subscriptions > Instances, lalu klik instance ABAP Anda.

  5. Di lingkungan ABAP yang terbuka, buka Semua ruang > Administrasi > Keamanan.

  6. Buka aplikasi Maintain Certificate Trust List.

  7. Klik Tambahkan.

  8. Pilih sertifikat yang Anda download dari repositori Layanan Kepercayaan Google.

  9. Klik Upload. Sertifikat ditambahkan ke daftar tepercaya.

Menginstal ABAP SDK edisi SAP BTP untuk Google Cloud

Anda menginstal ABAP SDK edisi SAP BTP untuk Google Cloud menggunakan SAP BTP Landscape Portal.

Untuk menginstal ABAP SDK edisi SAP BTP untuk Google Cloud, lakukan langkah-langkah berikut:

  1. Dapatkan produk ABAP SDK untuk Google Cloud yang tersedia di Landscape Portal Anda.

    1. Di bagian komponen BC-CP-ABA, buka kasus prioritas sedang dengan SAP menggunakan salah satu opsi berikut:

    2. Di deskripsi kasus, masukkan detail berikut:

      We would like the following product registered to our Landscape Portal:
* Product: /GOOG/ABAP_SDK
* Publisher: Google

    3. Berikan detail lainnya sesuai kebutuhan dan kirimkan kasus tersebut.

    Setelah SAP mengonfirmasi bahwa produk terdaftar ke Portal Lanskap Anda, lanjutkan ke langkah berikutnya.

    Diperlukan waktu hingga 3 hari kerja agar ABAP SDK untuk Google Cloud terdaftar di Landscape Portal Anda. Jika SDK masih belum terdaftar setelah waktu ini, hubungi Cloud Customer Care untuk mendapatkan bantuan. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan dukungan untuk SAP di Google Cloud.

  2. Deploy produk ABAP SDK untuk Google Cloud:

    1. Di Landscape Portal, buka aplikasi Deploy.
    2. Di kolom Product, pilih /GOOG/ABAP_SDK.
    3. Di kolom Target version, pilih 1.1.0.
    4. Di bagian Sistem yang tersedia, pilih instance ABAP tempat Anda perlu menginstal SDK.
    5. Klik Deploy. Bagian Product Version Deployment Status menampilkan status penyelesaian deployment.

Menambahkan aplikasi Fiori ke peluncur

Mulai versi 1.1, ABAP SDK untuk Google Cloud edisi SAP BTP dikemas dengan aplikasi Fiori SAP untuk konfigurasi SDK dan logging aplikasi. Sebagai administrator atau developer, Anda menggunakan aplikasi Fiori ini untuk mengonfigurasi SDK dan mengonfigurasi logging aplikasi. SDK juga menyediakan aplikasi Fiori khusus hanya untuk melihat konfigurasi autentikasi, konfigurasi logging, dan menganalisis log SDK.

Administrator atau developer yang mengonfigurasi SDK dan logging, atau pengguna yang hanya perlu melihat konfigurasi dan log SDK, harus memiliki akses ke aplikasi Fiori yang relevan. Untuk memberikan akses ke aplikasi Fiori SDK, Anda perlu menambahkan katalog bisnis ABAP SDK untuk Google Cloud ke peran bisnis pengguna yang melakukan konfigurasi SDK atau perlu melihat konfigurasi dan logging. ABAP SDK untuk Google Cloud edisi SAP BTP menyertakan template peran bisnis yang berisi katalog bisnis yang diperlukan untuk mengakses aplikasi Fiori.

Tabel berikut mencantumkan template peran bisnis dan aplikasi Fiori terkait yang menyediakan akses.

Template peran bisnis App name Deskripsi
/GOOG/BRT_SDK Google SDK: Konfigurasi Utama Gunakan aplikasi ini untuk mengonfigurasi autentikasi agar dapat terhubung dengan Google Cloud API secara aman.
Google SDK: Konfigurasi Log Aplikasi Gunakan aplikasi ini untuk mengonfigurasi logging guna merekam error, peringatan, dan pesan info ke dalam log aplikasi SAP.
Google SDK: Tampilan Log Aplikasi Gunakan aplikasi ini untuk melihat log aplikasi SDK.
Vertex AI SDK: Mengonfigurasi Parameter Gen Model Gunakan aplikasi ini untuk mengonfigurasi parameter pembuatan model.
Vertex AI SDK: Konfigurasi Penelusuran Vektor Gunakan aplikasi ini untuk mengonfigurasi parameter Vector Search.
/GOOG/BRT_SDK_DISPLAY Google SDK: Menampilkan Konfigurasi Utama Gunakan aplikasi ini untuk melihat konfigurasi SDK.
Google SDK: Konfigurasi Log Tampilan Gunakan aplikasi ini untuk melihat konfigurasi log aplikasi.
Google SDK: Tampilan Log Aplikasi Gunakan aplikasi ini untuk melihat log aplikasi SDK.
Vertex AI SDK: Menampilkan Parameter Gen Model Gunakan aplikasi ini untuk melihat parameter pembuatan model.
Vertex AI SDK: Menampilkan Konfigurasi Vector Search Gunakan aplikasi ini untuk melihat konfigurasi parameter Penelusuran Vektor.

Untuk menambahkan katalog bisnis ABAP SDK untuk Google Cloud ke peran bisnis pengguna menggunakan template peran bisnis yang disediakan, Anda harus memiliki akses ke katalog bisnis SAP_CORE_BC_SEC. Katalog bisnis ini disertakan dalam peran bisnis yang telah ditentukan sebelumnya SAP_BR_ADMINISTRATOR.

Membuat peran bisnis dan menetapkannya kepada pengguna

Mulai versi 1.1, ABAP SDK untuk Google Cloud edisi SAP BTP dikirimkan dengan ruang yang telah ditentukan /GOOG/SDK_CONFIG_SPACE dan halaman yang telah ditentukan /GOOG/SDK_CONFIG_PAGE, yang memudahkan Anda untuk memberi pengguna akses ke aplikasi SAP Fiori.

Untuk membuat peran bisnis dan menetapkannya kepada pengguna, lakukan langkah-langkah berikut:

  1. Di lingkungan ABAP, buka Semua ruang > Administrasi > Identity and Access Management.
  2. Buka aplikasi Maintain Business Roles.
  3. Klik Buat dari template.
  4. Pada dialog Create Business Role from Template yang muncul, masukkan nilai untuk kolom berikut:
    1. Template: masukkan /GOOG/BRT_SDK.
    2. ID Peran Bisnis Baru:masukkan ID peran bisnis.
    3. Deskripsi peran bisnis baru: masukkan deskripsi untuk peran bisnis.
    4. Opsi untuk Ruang: pastikan Gunakan Ruang yang Ditetapkan dipilih.
    5. Klik Oke.
  5. Di bagian Kategori akses, untuk kolom Bantuan Nilai, Tulis, Baca, pilih Tidak dibatasi.
  6. Buka tab Business Users, lalu klik Edit, lalu Add.
  7. Pada dialog Tambahkan Pengguna Bisnis yang muncul, telusuri dan pilih pengguna yang diperlukan yang memerlukan akses ke aplikasi Fiori SDK.
  8. Klik Oke. Pengguna dapat melihat ruang dan halaman yang ditetapkan dengan aplikasi Fiori SDK.
  9. Klik Save.
  10. Jika Anda ingin memberikan akses hanya lihat kepada beberapa pengguna ke aplikasi Fiori SDK, ulangi langkah-langkah di bagian ini menggunakan detail berikut:
    • Buat peran bisnis menggunakan template /GOOG/BRT_SDK_DISPLAY.
    • Di bagian Kategori akses, untuk kolom Bantuan Baca, Tulis, Nilai, pilih Tidak ada akses.

Mengonfigurasi autentikasi

Untuk menggunakan Google Cloud API, Anda harus mengonfirmasi identitas Anda dengan autentikasi. Untuk mengetahui informasi tentang opsi autentikasi keGoogle Cloud dan langkah-langkah penyiapannya, lihat Autentikasi.

Mengonfigurasi logging

ABAP SDK edisi SAP BTP untuk Google Cloud menggunakan log aplikasi SAP untuk menyimpan semua pesan yang ditampilkan selama eksekusi class library klien. Setelah Anda menentukan konfigurasi log default, SDK akan mulai mencatat pesan ke dalam log.

Objek log /GOOG/LOG_OBJECT dan subobjek /GOOG/LOG_SUBOBJECT dikirim bersama SDK yang dapat Anda gunakan untuk membuat konfigurasi log default.

Anda menggunakan aplikasi Google SDK: Konfigurasi Log Aplikasi untuk membuat konfigurasi log.

Anda dapat melihat log aplikasi menggunakan aplikasi Google SDK: Application Logs Display. Untuk informasi selengkapnya, lihat Melihat log.

Untuk membuat konfigurasi log, lakukan langkah-langkah berikut:

  1. Akses peluncur SAP Fiori.
  2. Buka ruang yang berisi aplikasi Fiori untuk konfigurasi SDK.
  3. Buka aplikasi Google SDK: Application Log Configuration.
  4. Klik Buat.

  5. Pada dialog Create yang muncul, masukkan nilai untuk kolom berikut:

    • Log config type: pilih OBJ_SUBOBJ.
    • Objek: pilih /GOOG/LOG_OBJECT.
    • Sub-objek: pilih /GOOG/LOG_SUBOBJECT.

  6. Klik Lanjutkan.

  7. Berikan detail berikut:

    • Hari retensi: menentukan jumlah hari log akan dipertahankan.

    • Level log: menentukan level log minimum. Nilai yang didukung adalah:

      • I: Informasi, Peringatan, dan Error
      • W: Peringatan dan Error
      • E: Hanya Error Sebaiknya tetapkan level log ke I, sehingga sebagian besar pesan log dicatat ke dalam log.

    • Akhir pada: tentukan tanggal akhir untuk masa aktif konfigurasi log ini. Tanggal akhir default-nya adalah 9999/12/31.

    • Adalah default: Untuk menjadikannya sebagai konfigurasi log default, centang kotak.

  8. Klik Buat.

Mengelola konfigurasi log

Jika konfigurasi log tidak lagi diperlukan, Anda dapat menonaktifkannya.

Untuk menonaktifkan konfigurasi log, lakukan langkah-langkah berikut:

  1. Buka aplikasi Google SDK: Application Log Configuration.
  2. Di kolom Editing status, pilih status yang sesuai, lalu klik Go.
  3. Klik entri konfigurasi log yang perlu Anda nonaktifkan.
  4. Klik Edit.
  5. Tetapkan End At ke tanggal sebelumnya.
  6. Klik Save.

Menentukan Google Cloud endpoint API

ABAP SDK untuk Google Cloud edisi SAP BTP menyediakan opsi berikut untuk menentukan endpoint API saat memanggil Google Cloud API menggunakan class library klien API:

  • Endpoint default
  • Endpoint kustom

Endpoint default

Secara default, setiap class API melakukan hardcode endpoint global sebagai nilai konstan. Library klien menggunakan endpoint ini saat metode dipanggil untuk menjalankan operasi pada resource API. Untuk menggunakan endpoint default, tidak diperlukan konfigurasi tambahan.

Endpoint kustom

Dalam skenario, saat Anda memerlukan fleksibilitas untuk menentukan endpoint sendiri, Anda dapat membuat endpoint kustom. Misalnya, Anda membuat endpoint kustom untuk membuat koneksi ke Google Cloud saat Anda perlu melakukan hal berikut:

  • Mengakses endpoint API spesifik per region untuk aplikasi yang peka terhadap latensi atau peraturan.
  • Gunakan API tertentu seperti Vertex AI, yang hanya menawarkan endpoint regional.

Untuk membuat endpoint kustom, Anda menggunakan skenario komunikasi /GOOG/COM_SDK_SRV yang dikirimkan dengan ABAP SDK untuk Google Cloud.

Prosedur berikut mengilustrasikan cara membuat endpoint regional untuk Pub/Sub API. Anda dapat mengikuti prosedur yang sama untuk membuat endpoint kustom untuk layanan Google Cloud lain yang didukung.

  1. Akses peluncur SAP Fiori dari sistem ABAP BTP tempat ABAP SDK untuk Google Cloud diinstal.
  2. Buka Semua ruang > Administrasi > Pengelolaan Komunikasi.
  3. Buat sistem komunikasi:
    1. Buka aplikasi Sistem Komunikasi.
    2. Klik New.
    3. Pada dialog New Communication System yang muncul, masukkan nilai untuk kolom berikut:
      • ID Sistem: masukkan ID sistem.
      • Nama sistem: masukkan nama sistem.
    4. Klik Buat.
    5. Di kolom Nama host, masukkan endpoint kustom Anda. Misalnya, masukkan endpoint regional untuk layanan Pub/Sub: https://asia-east1-pubsub.googleapis.com.
    6. Di kolom Port, masukkan 443.
    7. Pada tab Pengguna untuk Komunikasi Keluar, klik Tambahkan.
    8. Di kolom Authentication method, pilih None.
    9. Klik Buat.
    10. Untuk menyimpan sistem komunikasi, klik Save.

  4. Buat pengaturan komunikasi:

    1. Buka aplikasi Pengaturan Komunikasi.
    2. Klik New.

    3. Pada dialog New Communication Arrangement yang muncul, masukkan detail berikut:

      • Skenario: pilih Komunikasi Keluar untuk API apa pun (/GOOG/COM_SDK_SRV).
      • Nama pengaturan: masukkan nama untuk pengaturan komunikasi.

    4. Klik Buat.

    5. Untuk pengaturan komunikasi yang muncul, di kolom Communication System, pilih sistem komunikasi yang Anda buat di langkah sebelumnya.

    6. Di bagian Komunikasi keluar, di kolom Nama pengguna, pilih Tidak ada.

    7. Klik Save.

  5. Buat peta komunikasi untuk layanan API:

    1. Buka ruang yang berisi aplikasi Fiori untuk konfigurasi SDK.
    2. Buka aplikasi Google SDK: Main Configuration.
    3. Pilih kunci klien yang akan digunakan untuk membuat endpoint kustom. Asumsinya adalah Anda telah membuat kunci klien dan peta komunikasi untuk autentikasi. Jika belum, buat kunci klien dan peta komunikasi untuk autentikasi. Untuk informasi selengkapnya, lihat Autentikasi.
    4. Klik Buat.
    5. Pada dialog Create yang muncul, pilih nama layanan. Misalnya, pilih pubsub:v1.
    6. Klik Lanjutkan.
    7. Untuk peta komunikasi yang muncul, di kolom Communication arrangement, pilih pengaturan komunikasi yang Anda buat di langkah sebelumnya. Artefak komunikasi lainnya diisi secara otomatis.
    8. Klik Terapkan.
    9. Klik Save.
    10. Untuk memvalidasi konfigurasi endpoint kustom, klik Check connection. Centang hijau untuk entri menunjukkan konfigurasi yang berhasil. Jika terjadi error, buka halaman pemecahan masalah untuk mendapatkan panduan guna mengatasi error umum.

Metrik penggunaan

ABAP SDK untuk Google Cloud edisi SAP BTP mengumpulkan metrik penggunaan dan mengirimkannya ke Google untuk tujuan dukungan, sesuai dengan Pemberitahuan Privasi Google Cloud (Data Layanan yang Kami Kumpulkan). Metrik penggunaan ini dikumpulkan setiap kali Google Cloud API dipanggil dari ABAP SDK untuk Google Cloud.

SDK mengumpulkan metrik penggunaan berikut:

  • Metode autentikasi: informasi tentang metode autentikasi yang digunakan untuk memanggil layanan Google Cloud .
  • Versi ABAP SDK: nomor versi ABAP SDK edisi SAP BTP untuk Google Cloud.
  • Rilis SAP_ABA: versi komponen software SAP_ABA.

Pemberian Lisensi

ABAP SDK edisi SAP BTP untuk Google Cloud tersedia sebagai "Software" berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform oleh Anda, termasuk Persyaratan Khusus Layanan yang tersedia di https://cloud.google.com/terms/service-terms. Tanpa membatasi umumnya persyaratan sebelumnya, Anda tidak boleh memodifikasi atau mendistribusikan ABAP SDK untuk Google Cloud tanpa izin tertulis yang jelas dari Google.

Software ABAP SDK untuk Google Cloud ditawarkan tanpa biaya. Agar lebih jelas, penggunaan "Software" dan "Layanan" lainnya oleh Anda berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform, seperti Cloud Translation API dan Pub/Sub API dapat dikenai biaya.

ABAP SDK untuk Google Cloud tidak menyertakan lisensi apa pun untuk software SAP. Anda perlu membeli lisensi yang sesuai secara terpisah untuk software SAP.

Siklus proses dukungan

Google Cloud mendukung dan mempertahankan versi utama ABAP SDK untuk Google Cloud edisi SAP BTP saat ini selama minimal 12 bulan setelah publikasi pemberitahuan penghentian penggunaan versi utama sebelumnya di halaman Catatan Rilis untuk SAP di Google Cloud.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait ABAP SDK untuk Google Cloud, lakukan langkah-langkah berikut: