Jak śledzić dzienniki kompilacji Tail Cloud Manager w AEM jako usłudze w chmurze i AMS
Jak wygląda menedżer chmury AEM podczas wdrażania do AEM jako usługi w chmurze
WAŻNE: Zastrzeżenia dotyczące rejestrowania Ograniczenia funkcji „ & ”
Obecnie istnieje kilka zastrzeżeń dotyczących ograniczeń & (które oczywiście mogą ulec zmianie) dotyczących śledzenia dzienników kompilacji za pomocą Adobe I/O:
- & M ożna śledzić tylko krok „Tworzenie testów jednostkowych & ”. Jedynym dziennikiem wykonania, który można śledzić, jest krok „Tworzenie testów jednostkowych & ”, w którym kod jest sprawdzany, kompilowany i testowany. Dotyczy to również potoku „warstwy internetowej”. Oznacza to, że nie można uzyskać szczegółowego opisu poszczególnych etapów testowania jakości kodu ani wyników w przypadku niepowodzenia. & oczekuje na interakcję użytkownika. Ponadto etap, w którym kod jest faktycznie wdrażany i umieszczany na serwerach, nie może być śledzony w usłudze chmury, mimo że jest to etap trwający czasami nawet 45 minut.
- Logi nie uwzględnione w Splunk: Logi, które śledzisz, nie są uwzględnione w wynikach Splunk, które otrzymujesz, jeśli zdecydujesz się wysłać logi usługi AEM Cloud Service do Splunk (szczegółowe informacje znajdziesz w artykule). Oznacza to, że dopóki nie znajdziemy sposobu na bezpośrednie przekazywanie logów AIO do Splunk, nie ma możliwości skorelowania znaczników czasu z wynikami logowania, jeśli chcesz porównać jedną kompilację z inną itp.
Oto kroki, które należy wykonać, aby śledzić logi w środowisku AEM jako usługa w chmurze:
Krok 1: Dostęp do Adobe IO dla Cloud Manager
Pierwszym krokiem, który należy sprawdzić, jest upewnienie się, że konto Adobe ma uprawnienia do tworzenia integracji usług w Adobe IO za pomocą Cloud Manager. Jeśli wejdziesz na stronę https://console.adobe.io przy użyciu swojego identyfikatora Adobe ID i utworzysz nowy projekt, wybierz opcję „Dodaj API”. W sekcji Experience Cloud na liście dostępnych integracji powinna pojawić się pozycja „Cloud Manager”.
Jak powinna wyglądać konsola Adobe IO, jeśli masz dostęp do Cloud Manager
Jeśli nie widzisz tam Cloud Manager (tak jak ja na początku), wyślij wiadomość e-mail do przedstawiciela handlowego Adobe lub pomocy SPP (w przypadku instancji Sandbox), którzy pomogą Ci rozwiązać problem.
Krok 2: Utwórz projekt Adobe IO dla swojego menedżera chmury (i dzienników) Dostęp
Następnie należy utworzyć parę kluczy publicznego/prywatnego, która generuje nowe poświadczenie konta usługi (JWT), które będzie później używane do uwierzytelniania konsoli Adobe IO w środowisku Cloud Manager jako użytkownik. Zapisz tę parę kluczy publicznego i prywatnego na swoim komputerze, ponieważ będzie ona potrzebna wkrótce.
Następnie należy określić, do jakich usług integracja będzie miała dostęp:
A potem kliknij „ZAPISZ SKONFIGUROWANE API”.
Krok 3: Zainstaluj środowisko uruchomieniowe Adobe IO
Na tej stronie znajdują się pełne instrukcje instalacji środowiska uruchomieniowego Adobe IO. Krótko mówiąc, po zainstalowaniu NodeJS na stacji roboczej należy:
$ npm install -g @adobe/aio-cli
Po instalacji powinno pojawić się następujące okno:
$ aio -v
@adobe/aio-cli/3.5.0 win32-x64 node-v12.18.0
Krok 4: Zainstaluj wtyczkę Adobe IO Cloud Manager CLI w przeglądarce & Skonfiguruj wtyczkę Adobe IO Cloud Manager CLI
Pełna instrukcja instalacji znajduje się tutaj, ale w skrócie należy uruchomić:
$ aio plugins:install @adobe/aio-cli-plugin-cloudmanager
Następnie, po zainstalowaniu, należy pobrać elementy z utworzonej integracji Adobe IO i wkleić je do pliku config.json, którego można użyć do skonfigurowania menedżera chmury. Będzie się składać z:
//config.json
{
"client_id": "value from your CLI integration (String)",
"client_secret": "value from your CLI integration (String)",
"jwt_payload": { value from your CLI integration (JSON Object Literal) },
"token_exchange_url": "https://ims-na1.adobelogin.com/ims/exchange/jwt"
}
Umieść ten plik na swojej stacji roboczej, a następnie uruchom następujące polecenie, aby skonfigurować poświadczenia:
aio config:set jwt-auth PATH_TO_CONFIG_JSON_FILE --file --json
Następnie podaj mu swój prywatny certyfikat, który zapisałeś wcześniej z Adobe IO:
aio config:set jwt-auth.jwt_private_key PATH_TO_PRIVATE_KEY_FILE --file
Krok 5: Poinformuj AIO, jaki jest Twój domyślny program
Następnie poinformuj środowisko uruchomieniowe Adobe IO, jaki jest Twój „program domyślny”. W usłudze AEM jako usługa w chmurze „program” to zbiór środowisk tworzących jedną właściwość internetową. Przejście do strony my.cloudmanager.adobe.com, Po zalogowaniu się zobaczysz adres URL w formacie „https://experience.adobe.com/#/@the_cool_name_of_my_company/cloud-manager/home.html/program/{PROGRAM_NUMBER}”.
Liczba na końcu to numer programu, który możesz podać AIO w następujący sposób (zakładając, że „1234” to identyfikator programu):
$ aio config:set cloudmanager_programid 1234
Krok 6: Rozpocznij kompilację z AIO & Skopiuj identyfikator kompilacji
Wyświetl listę dostępnych potoków za pomocą polecenia aio cloudmanagerlist-pipelines:
tad@tad-Precision-7750:~/OneDrive/ICF/aio/config$ aio cloudmanager:program:list-pipelines
Pipeline Id Name Status
─────────── ──────────────────────────────────────── ──────
7239327 Web-Tier Only BUSY
4042555 Non-Production Pipeline IDLE
1023673 Non-Prod Code Only- DEV IDLE
299672 Non-Production Code Quality Pipeline[PT] IDLE
298825 Production Pipeline IDLE
298163 Non-Production Pipeline IDLE
Załóżmy, że chcesz śledzić dziennik kompilacji swojego pełnego stosu nieprodukcyjnego potoku. W tym przypadku identyfikator potoku to „4042555” z powyższej listy.
Następnie można uruchomić ten potok za pomocą polecenia aio cloudmanagercreate-execution:
tad@tad-Precision-7750:~/OneDrive/aio/config$ aio cloudmanager:pipeline:create-execution 4042555
starting execution... started execution ID 4042555
Następnie można zobaczyć, że wykonanie zostało uruchomione za pomocą polecenia aio cloudmanagerlist-current-executions:
tad@tad-Precision-7750:~/OneDrive/aio/config$ aio cloudmanager:program:list-current-executions
Pipeline Id Execution Id Started At Execution Status Trigger Current Step Action Current Step Status
─────────── ──────────── ───────────────────── ──────────────── ─────── ─────────────────── ───────────────────
4042555 198305 March 8, 2022 3:50 PM RUNNING MANUAL Build RUNNING
Krok 7: Dodaj AIO do dziennika kompilacji
Następnie, po rozpoczęciu wykonywania, możesz użyć polecenia aio cloudmanagertail-step-log wraz z identyfikatorem kompilacji, aby wyświetlić dzienniki kompilacji:
tad@tad-Precision-7750:~/OneDrive/aio/config$ aio cloudmanager:execution:tail-step-log 4042555
2022-03-09T00:15:38+0000 The following build artifacts were reused from the prior execution 1132597 of pipeline 4043554 which used commit 38xxxfe09abc93e08073fa1735924f164:
2022-03-09T00:15:38+0000 * build/mycorp.all-1.0.0-SNAPSHOT.zip (content-package)
2022-03-09T00:15:38+0000 * build/core-components-accelerator.all-1.0.0-SNAPSHOT.zip (content-package)
2022-03-09T00:15:38+0000 * build/mycorp.it.tests-1.0.0-SNAPSHOT-jar-with-dependencies.jar (functional-tests)
I gotowe! Daj mi znać, jeśli napotkasz jakieś problemy lub jeśli uda Ci się znaleźć sposób na przeniesienie tych logów do Splunk!
O autorze
Tad Reeves
Główny architekt w Arbory Digital
Architekt AEM & DevOps z 14-letnim doświadczeniem w AEM/CQ i ponad 25-letnim doświadczeniem w infrastrukturze systemowej.
Podoba ci się to, co usłyszałeś? Masz pytania dotyczące tego, co jest dla Ciebie odpowiednie? Chętnie porozmawiamy! Skontaktuj się z nami