Zainstaluj wersję próbną platformy ABAP 2022 w Google Cloud Platform i zainstaluj pakiet SDK ABAP

1. Wprowadzenie

W tym module znajdziesz instrukcje instalacji ABAP Platform Trial 2022 w Google Cloud, a następnie ABAP SDK for Google Cloud.

Używamy skryptów hostowanych w tym repozytorium GitHub. Plik README w repozytorium zawiera szczegółową dokumentację funkcji skryptu.

W tym module używane są te usługi Google Cloud:

• Compute Engine
• Usługi sieciowe
• Cloud Shell

Co utworzysz

Za pomocą skryptu utworzysz:

• Instancja Compute Engine z wersją próbną platformy ABAP 2022 działającą w kontenerze Dockera.
• Reguły zapory sieciowej.
• Konto usługi do uzyskiwania dostępu do interfejsów Google Cloud API za pomocą pakietu ABAP SDK for Google Cloud.

2. Wymagania

• przeglądarka, np. Chrome lub Firefox;
• Projekt Google Cloud z włączonym rozliczeniem lub utwórz 90-dniowe konto próbne w Google Cloud Platform.
• SAP GUI (Windows lub Java) zainstalowany w systemie. Jeśli SAP GUI jest już zainstalowany na laptopie, połącz się z SAP, używając zewnętrznego adresu IP maszyny wirtualnej jako adresu IP serwera aplikacji. Jeśli korzystasz z komputera Mac, możesz też zainstalować interfejs SAP GUI dla Javy, który jest dostępny pod tym linkiem.

3. Zanim zaczniesz

1. W konsoli Google Cloud na stronie selektora projektów wybierz lub utwórz projekt Google Cloud (np. abap-sdk-poc).
2. Sprawdź, czy w projekcie Cloud włączone są płatności. Dowiedz się, jak sprawdzić, czy w projekcie włączone są płatności. Pomiń ten krok, jeśli korzystasz z 90-dniowego konta próbnego.
3. Będziesz używać Cloud Shell, czyli środowiska wiersza poleceń działającego w Google Cloud.
4. W prawym górnym rogu Cloud Console kliknij Aktywuj Cloud Shell:

5. Uruchom te polecenia, aby uwierzytelnić się na koncie i ustawić domyślny projekt na abap-sdk-poc. Jako przykładu używamy strefy us-west4-b. W razie potrzeby zmień projekt i strefę w tych poleceniach zgodnie ze swoimi preferencjami. Te parametry są używane przez skrypt instalacyjny.

gcloud auth login
gcloud config set project abap-sdk-poc
gcloud config set compute/zone us-west4-b

4. Uruchamianie skryptu tworzenia

• Aby uruchomić skrypt create_vm_withdocker.sh, wykonaj to polecenie:

mkdir sap-docker-2022
cd sap-docker-2022
git clone https://github.com/google-cloud-abap/abap-cloud-trial-2022-gcp.git
cd abap-cloud-trial-2022-gcp
chmod 755 create_vm_with_docker.sh
./create_vm_with_docker.sh

Skrypt wykona te działania:

• Utwórz maszynę wirtualną (nazwa: abap-trial-docker, konfiguracja: n2-highmem-4, system operacyjny i dysk: debian-12-bookworm-v20240815, 200gb).
• Zainstaluj najnowszą wersję Docker Engine.
• Pobierz i uruchom kontener docker w wersji próbnej platformy ABAP 2022.
• Aktywuj usługę danych logowania konta usługi IAM i usługę weryfikacji adresu, których użyjemy do oceny pakietu ABAP SDK w kolejnych ćwiczeniach z programowania.
• Utwórz konto usł[e-mail],, które będzie używane przez pakiet ABAP SDK.

Uwaga: skrypt automatycznie zaakceptuje warunki licencji SAP w imieniu wykonawcy za pomocą flagi –

agree-to-sap-license. (Więcej informacji o licencji znajdziesz w sekcji licencji na stronie Docker Hub).

5. Monitorowanie instalacji

Utworzenie maszyny wirtualnej zajmie kilka minut, ale zainstalowanie kontenera Dockera SAP potrwa około 15 minut.

Aby monitorować proces instalacji:

1. Po utworzeniu maszyny wirtualnej połącz się z systemem za pomocą SSH, wykonując jedną z tych czynności:

• W Cloud Console kliknij przycisk SSH.

• Uruchom w terminalu Cloud Shell to polecenie:

gcloud compute ssh "abap-trial-docker-2022"

2. Skrypt instalacyjny tworzy plik wyjściowy /tmp/output.txt. Aby monitorować proces instalacji, uruchom polecenie tail z tym plikiem.

tail -f /tmp/output.txt

3. Poczekaj, aż w pliku wyjściowym pojawi się poniższy komunikat potwierdzający, że kontener Dockera SAP działa.

Aby sprawdzić, czy kontener działa, możesz też uruchomić to polecenie:

sudo docker ps

Instalacja została zakończona. Możemy teraz przejść do następnego kroku, czyli połączenia z systemem.

6. Testowanie połączenia z systemem SAP

Możesz teraz połączyć się z systemem SAP.

• Uruchom to polecenie, aby uzyskać zewnętrzny adres IP maszyny wirtualnej, lub sprawdź go w konsoli Google Cloud.

gcloud compute instances describe abap-trial-docker  \
--format='get(networkInterfaces[0].accessConfigs[0].natIP)'

Aby połączyć się z SAP GUI, użyj tych informacji:

• Identyfikator systemu: A4H
• Numer instancji: 00
• Serwer aplikacji: <External IP Address>

Nazwa użytkownika to DEVELOPER, a hasło to ABAPtr2022#00. Jest on również predefiniowany (to samo hasło) dla klientów 000 i 001: SAP*, DDIC. Więcej informacji znajdziesz tutaj.

7. Odnawianie licencji próbnej SAP

Aby odnowić licencję próbną SAP, wykonaj te czynności:

1. Zaloguj się w systemie, używając tych danych logowania:

Klient:	001
Identyfikator użytkownika:	SAP*
Hasło:	ABAPtr2022#00

2. Pobierz klucz sprzętowy z kodu T: SLICENSE

3. Wygeneruj nowy klucz licencyjny na stronie SAP License Keys for Preview, Evaluation and Developer Versions (Klucze licencyjne SAP dla wersji podglądowych, testowych i dla programistów). Wybierz system A4H, zaktualizuj dane osobowe i informacje o systemie za pomocą klucza sprzętowego oraz zaakceptuj licencję. Kliknij przycisk Wygeneruj, aby utworzyć plik klucza licencyjnego A4H_Multiple.txt.

4. Zainstaluj nowy klucz licencyjny za pomocą kodu T: SLICENSE

• Otwórz kod transakcji SLICENSE, kliknij przycisk Zainstaluj i wybierz pobrany dokument tekstowy A4H_Multiple.txt. System zostanie przedłużony o kolejne 3 miesiące.

8. Aktywowanie konfiguracji TMS

Aby zaimportować transporty do systemu, musimy aktywować konfigurację TMS.

1. Zaloguj się w systemie, podając nazwę użytkownika DEVELOPER i hasło ABAPtr2022#00.
2. Otwórz kod transakcji STMS > Przegląd > Importy.

3. Kliknij Środowisko > Przegląd systemu.

4. Wybierz Dodatki > Rozpowszechnij i aktywuj konfigurację.

5. Otwórz kod transakcji STMS_IMPORT. Powinien się wyświetlić ten ekran:

System SAP jest teraz gotowy do importowania dowolnych transportów.

9. Konfigurowanie certyfikatu zaufania

Aby bezpiecznie łączyć się z interfejsami API Google za pomocą pakietu ABAP SDK, musisz mieć certyfikaty zaufania.

1. Pobierz na komputer te certyfikaty z repozytorium Google Trust Services:

• GTS Root R1 (PEM)
• GTS CA 1C3 (PEM)

2. W interfejsie SAP GUI użyj transakcji STRUST, aby zaimportować certyfikat główny i podrzędny do folderu SSL Client (Standard) PSE klienta SSL.
3. W STRUST wybierz węzeł SSL client SSL Client (Standard) (Klient SSL Klient SSL (standardowy)) i kliknij Import certificate (Importuj certyfikat), aby przesłać oba pliki. Następnie kliknij Add to Certificate List (Dodaj do listy certyfikatów) i Save (Zapisz).

10. Importowanie najnowszej wersji pakietu ABAP SDK for Google Cloud

Pliki transportowe pakietu ABAP SDK for Google Cloud są dostępne pod tym linkiem. Aby przyspieszyć ten proces, przeprowadzimy importowanie za pomocą skryptu.

1. W Cloud Shell połącz się z maszyną wirtualną SAP Docker przez SSH:

gcloud compute ssh "abap-trial-docker-2022"

2. Pobierz i uruchom skrypt transportu importu:

wget https://raw.githubusercontent.com/google-cloud-abap/abap-cloud-trial-2022-gcp/main/import_abap_sdk.sh
chmod 755 import_abap_sdk.sh
./import_abap_sdk.sh

3. Po zakończeniu sprawdź, czy pakiet /GOOG/ABAP_SDK znajduje się w SE80. Pakiet ABAP SDK został zainstalowany.

11. Napisz przykładowy program ABAP za pomocą pakietu ABAP SDK

Napiszmy przykładowy program ABAP, który będzie korzystać z usługi weryfikacji adresu do poprawiania adresu. Postępuj zgodnie z instrukcjami w tym samouczku: Konfigurowanie uwierzytelniania pakietu ABAP SDK za pomocą tokenów w przypadku SAP hostowanego na maszynie wirtualnej Compute Engine

12. Gratulacje

Gratulacje! Udało Ci się zainstalować wersję próbną platformy ABAP 2022 w Google Cloud Platform i zaimportować transporty dla ABAP SDK for Google Cloud.

System próbny SAP umożliwi Ci poznanie pakietu ABAP SDK.

Możesz teraz przejść do innych ćwiczeń z programowania dotyczących pakietu SDK ABAP, aby kontynuować naukę korzystania z pakietu SDK ABAP dla Google Cloud w celu uzyskiwania dostępu do różnych usług Google Cloud.

13. Czyszczenie danych

Jeśli nie chcesz kontynuować pracy z dodatkowymi ćwiczeniami dotyczącymi pakietu ABAP SDK do Google Cloud, przejdź do sekcji czyszczenia.

Usuwanie projektu

Uwaga: usunięcie projektu spowoduje, że:

• Wszystkie dane projektu zostaną usunięte. Jeśli do wykonania zadań opisanych w tym dokumencie użyto istniejącego projektu, po jego usunięciu usuniesz też wszystkie inne wykonane w nim czynności.
• Niestandardowe identyfikatory projektu zostaną utracone. Podczas tworzenia tego projektu możesz utworzyć niestandardowy identyfikator projektu, którego chcesz używać w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, np. adres URL appspot.com, usuń wybrane zasoby w projekcie zamiast usuwać cały projekt.

Jeśli zamierzasz skorzystać z różnych architektur, samouczków lub krótkich wprowadzeń, ponowne wykorzystanie tych samych projektów może pomóc Ci uniknąć przekroczenia limitów związanych z projektami.

• Usuń projekt Google Cloud:

gcloud projects delete abap-sdk-poc

Usuwanie poszczególnych zasobów

1. Usuń instancję obliczeniową:

gcloud compute instances delete abap-trial-docker

2. Usuń reguły zapory sieciowej:

gcloud compute firewall-rules delete sapmachine

3. Usuń konto usługi:

gcloud iam service-accounts delete \
    [e-mail]