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

1. Wprowadzenie

W ramach tego ćwiczenia w programie przedstawiamy czynności, które musisz wykonać, aby zainstalować w Google Cloud wersję próbną platformy ABAP 2022 i zainstalować pakiet SDK ABAP dla Google Cloud.

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

W tym ćwiczeniu z programowania używane są następujące usługi Google Cloud:

• Compute Engine
• Usługi sieciowe
• Cloud Shell

Co utworzysz

Za pomocą skryptu utworzysz następujące elementy:

• Instancja Compute Engine z wersją próbną platformy ABAP 2022 uruchomioną w kontenerze Dockera.
• Reguły zapory sieciowej.
• Konto usługi umożliwiające dostęp do interfejsów API Google Cloud za pomocą pakietu SDK ABAP dla Google Cloud.

2. Wymagania

• Przeglądarka, na przykład Chrome lub Firefox.
• Projekt Google Cloud z włączonymi płatnościami lub utwórz bezpłatne konto próbne na 90 dni dla Google Cloud Platform.
• zainstalowanego w systemie SAP GUI (Windows lub Java). Jeśli SAP GUI jest już zainstalowany na Twoim laptopie, połącz się z nim, używając zewnętrznego adresu IP maszyny wirtualnej jako adresu IP serwera aplikacji. Jeśli korzystasz z komputera Mac, możesz również zainstalować interfejs SAP GUI dla języka Java dostępny tutaj.

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 są włączone płatności. Pomiń ten krok, jeśli używasz 90-dniowego bezpłatnego konta próbnego.
3. Użyjesz Cloud Shell – środowiska wiersza poleceń działającego w Google Cloud.
4. W konsoli Cloud kliknij Aktywuj Cloud Shell w prawym górnym rogu:

5. Uruchom te polecenia, aby uwierzytelnić się na swoim koncie i ustawić projekt domyślny na abap-sdk-poc. Przykładem jest strefa us-west4-b. W razie potrzeby zmień projekt i strefę w poniższych poleceniach. Te parametry są używane przez skrypt instalacji.

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

4. Wykonaj skrypt tworzenia

• Uruchom to polecenie, aby wykonać skrypt create_vm_withdocker.sh.

mkdir sap-docker-2022
git clone https://github.com/google-cloud-abap/abap-cloud-trial-2022-gcp.git
chmod 755 create_vm_with_docker.sh
cd abap-cloud-trial-2022-gcp
./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ę silnika Dockera.
• Pociągnij i uruchom kontener dockera platformy ABAP w wersji próbnej 2022.
• Aktywuj usługę danych logowania na konto usługi IAM i usługę weryfikacji adresów, których używamy do oceny pakietu SDK ABAP w kolejnych modułach dotyczących kodu.
• Utwórz konto usługi, [e-mail],które będzie używane przez pakiet SDK ABAP.

Uwaga: skrypt automatycznie zaakceptuje warunki licencji SAP w imieniu wykonawcy, używając flagi.

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

5. Monitorowanie instalacji

Maszyna wirtualna zostanie utworzona w ciągu kilku minut, ale instalacja kontenera Dockera SAP zajmie około 15 minut.

Aby monitorować proces instalacji, wykonaj następujące czynności:

1. Po utworzeniu maszyny wirtualnej połącz się z systemem przez SSH za pomocą jednej z tych metod:

• Kliknij przycisk SSH w konsoli Cloud.

• Uruchom w terminalu Cloud Shell to polecenie:

gcloud compute ssh "abap-trial-docker"

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

tail -f /tmp/output.txt

3. Poczekaj, aż w pliku wyjściowym pojawi się komunikat z potwierdzeniem znajdujący się poniżej, że kontener Dockera SAP jest uruchomiony.

Aby sprawdzić, czy kontener jest uruchomiony, możesz też uruchomić to polecenie:

sudo docker ps

Na tym kończy się instalacja i teraz możemy przejść do następnego kroku, czyli łączenia się 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)'

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

• Identyfikator systemu: A4H
• Numer instancji: 00
• Serwer aplikacji: <zewnętrzny adres IP>

Nazwa użytkownika to DEVELOPER z hasłem ABAPtr2022#00. Jest to również wstępnie zdefiniowane (to samo hasło) dla klienta 000, klient 001: SAP*, DDIC. Więcej informacji znajdziesz tutaj.

7. Odnów licencję próbną SAP

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

1. Zaloguj się do systemu przy użyciu następujących danych logowania:

Klient:	001
UserID:	SAP*
Hasło:	ABAPtr2022#00

2. Uzyskaj klucz sprzętowy z kodu Tcode: SLICENSE

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

4. Zainstaluj nowy klucz licencyjny, korzystając z kodu Tcode: SLICENSE

• Przejdź do kodu Tcode: SLICENSE, kliknij przycisk Zainstaluj i wybierz pobrany dokument tekstowy A4H_Multiple.txt. Okres ten zostanie przedłużony na kolejne 3 miesiące.

8. Aktywuj konfigurację TMS

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

1. Zaloguj się w systemie za pomocą nazwy użytkownika DEVELOPER i hasła Htods70334.
2. Przejdź do TCode STMS > Omówienie > Importowanie.

3. Wybierz Środowisko > Omówienie systemu.

4. Wybierz Dodatki > Rozpowszechnianie i aktywowanie konfiguracji

5. Przejdź do T-Code STMS_IMPORT. Zobaczysz ten ekran:

Teraz system SAP jest gotowy do importowania wszelkich transportów.

9. Skonfiguruj certyfikat zaufania

Aby można było bezpiecznie łączyć się z interfejsami API Google przy użyciu pakietu SDK ABAP, wymagane są certyfikaty zaufania.

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

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

2. W GUI SAP użyj transakcji STRUST, aby zaimportować certyfikat główny i podrzędny do folderu PSE klienta SSL (standardowy) klienta SSL.
3. W sekcji STRUST wybierz węzeł klienta SSL klienta SSL (standardowy) i kliknij Importuj certyfikat, aby przesłać oba pliki. Następnie kliknij Dodaj do listy certyfikatów i Zapisz.

10. Importuj pakiet SDK ABAP dla Google Cloud do najnowszej wersji

Pliki transportowe pakietu SDK ABAP dla Google Cloud są dostępne tutaj. Aby przyspieszyć importowanie, uruchomimy skrypt za pomocą skryptu.

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

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

2. Pobierz i wykonaj skrypt importu transportu:

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. Gdy to zrobisz, sprawdź przesyłkę /GOOG/ABAP_SDK w aplikacji SE80. Masz teraz zainstalowany pakiet SDK ABAP.

11. Napisanie przykładowego programu ABAP za pomocą pakietu SDK ABAP

Napiszmy przykładowy program ABAP, który będzie używać usługi weryfikacji adresów do poprawiania adresów. Wykonaj ćwiczenia z programowania dotyczące konfigurowania uwierzytelniania pakietu SDK ABAP za pomocą tokenów dla SAP hostowanych w maszynie wirtualnej Compute Engine.

12. Gratulacje

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

Dzięki wersji próbnej SAP możesz dowiedzieć się więcej o pakiecie SDK ABAP.

Możesz teraz ukończyć inne ćwiczenia z programowania z pakietu SDK ABAP, aby dowiedzieć się, jak używać pakietu SDK ABAP w Google Cloud do uzyskiwania dostępu do różnych usług Google Cloud.

13. Czyszczenie danych

Jeśli nie chcesz wykonywać dodatkowych ćwiczeń z programowania związanych z pakietem SDK ABAP dla Google Cloud, możesz kontynuować czyszczenie.

Usuwanie projektu

Uwaga: usunięcie projektu spowoduje, że:

• Wszystkie dane projektu zostaną usunięte. Jeśli do zadań w tym dokumencie został użyty istniejący projekt, usunięcie go spowoduje również usunięcie wszystkich innych zadań wykonanych w tym projekcie.
• Niestandardowe identyfikatory projektu zostaną utracone. Być może w trakcie tworzenia tego projektu został utworzony niestandardowy identyfikator projektu, którego chcesz używać w przyszłości. Aby zachować adresy URL, które używają identyfikatora projektu, na przykład adresu URL appspot.com, usuń wybrane zasoby w projekcie, zamiast usuwać cały projekt.

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

• 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]