Używanie akceleratora aplikacji VMware Tanzu z planem Azure Spring Apps Enterprise

Ten artykuł dotyczy: ❎ Podstawowa/Standardowa ✅ Enterprise

W tym artykule pokazano, jak używać Application Accelerator dla VMware Tanzu (App Accelerator) z planem Azure Spring Apps Enterprise, aby rozpoczynać tworzenie aplikacji w sposób czytelny i powtarzalny.

Akcelerator aplikacji pomaga w rozpoczynaniu tworzenia twoich aplikacji oraz wdrażaniu ich w sposób łatwo odnajdowany i powtarzalny. Akcelerator aplikacji umożliwia tworzenie nowych projektów opartych na opublikowanych projektach akceleratora. Aby uzyskać więcej informacji, zobacz Application Accelerator for VMware Tanzu (Akcelerator aplikacji dla programu VMware Tanzu ) w dokumentacji programu VMware.

Wymagania wstępne

• Subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

• Interfejs wiersza polecenia platformy Azure z rozszerzeniem Azure Spring Apps. Użyj następującego polecenia, aby usunąć poprzednie wersje i zainstalować najnowsze rozszerzenie. Jeśli wcześniej zainstalowano spring-cloud rozszerzenie, odinstaluj je, aby uniknąć niezgodności konfiguracji i wersji.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Aby użyć akceleratora aplikacji w programie VS Code, należy również spełnić następujące wymagania wstępne:

  • Visual Studio Code
  • Rozszerzenie Usługi Azure Spring Apps dla programu Visual Studio Code

Włączanie akceleratora aplikacji

Możesz włączyć Akcelerator aplikacji podczas aprowizowania instancji planu Enterprise usługi Azure Spring Apps. Jeśli masz już zasób planu Azure Spring Apps Enterprise, zobacz sekcję Zarządzanie akceleratorem aplikacji w istniejącym wystąpieniu planu Enterprise, aby go włączyć.

Akcelerator aplikacji można włączyć przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Monitorowanie akceleratora aplikacji

Akcelerator aplikacji umożliwia generowanie nowych projektów na podstawie plików w repozytoriach Git. W poniższej tabeli opisano składniki akceleratora aplikacji:

Uruchomione wystąpienia i użycie zasobów wszystkich składników można zobaczyć za pomocą portalu Azure lub Azure CLI.

az spring application-accelerator show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Konfigurowanie narzędzi deweloperskich w celu uzyskania dostępu do akceleratora aplikacji

Aby uzyskać dostęp do akceleratora aplikacji, należy skonfigurować narzędzia Tanzu Dev Tools. Aby uzyskać więcej informacji, zobacz Configure Tanzu Dev Tools in the Azure Spring Apps Enterprise plan (Konfigurowanie narzędzi Tanzu Dev Tools w planie Azure Spring Apps Enterprise).

Używanie akceleratora aplikacji do uruchamiania nowych projektów

Aby użyć akceleratora aplikacji do uruchamiania nowych projektów, musisz uzyskać uprawnienia do zarządzania akceleratorami. Następnie można zarządzać wstępnie zdefiniowanymi akceleratorami lub własnymi akceleratorami.

Uzyskiwanie uprawnień do zarządzania akceleratorami

Zarządzanie akceleratorami wymaga następujących uprawnień:

• Czytaj: Uzyskaj wstępnie zdefiniowany akcelerator usługi Azure Spring Apps
• Inne: Wyłączanie wstępnie zdefiniowanego akceleratora usługi Azure Spring Apps
• Inne: Włączanie wstępnie zdefiniowanego akceleratora usługi Azure Spring Apps
• Napisz: Utwórz lub zaktualizuj niestandardowy akcelerator dla Microsoft Azure Spring Apps
• Przeczytaj: Uzyskiwanie niestandardowego akceleratora usługi Azure Spring Apps

Aby uzyskać więcej informacji, zobacz How to use permissions in Azure Spring Apps (Jak używać uprawnień w usłudze Azure Spring Apps).

Zarządzanie wstępnie zdefiniowanymi akceleratorami

Możesz rozpocząć od kilku wstępnie zdefiniowanych akceleratorów, aby rozpocząć uruchamianie nowych projektów. Możesz wyłączyć lub włączyć wbudowane akceleratory zgodnie z własnymi preferencjami.

Akceleratory wstępnie zdefiniowane można zarządzać przy użyciu witryny Azure Portal i interfejsu wiersza polecenia platformy Azure.

az spring application-accelerator predefined-accelerator list \
    --resource-group <resource-group-name> \
    --service <service-instance-name>

az spring application-accelerator predefined-accelerator disable \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <predefined-accelerator-name>

az spring application-accelerator predefined-accelerator enable \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <predefined-accelerator-name>

Zarządzanie własnymi akceleratorami

Oprócz korzystania ze wstępnie zdefiniowanych akceleratorów można tworzyć własne akceleratory. Możesz użyć dowolnego repozytorium Git w usłudze Azure DevOps, GitHub, GitLab lub Bitbucket.

Wykonaj następujące kroki, aby utworzyć i zachować własne akceleratory:

Najpierw utwórz plik o nazwie accelerator.yaml w katalogu głównym repozytorium Git.

Możesz użyć pliku accelerator.yaml , aby zadeklarować opcje wejściowe, które użytkownicy wypełniają przy użyciu formularza w interfejsie użytkownika. Te wartości opcji kontrolują przetwarzanie przez silnik szablonów, przed zwróceniem spakowanych plików wyjściowych. Jeśli nie dołączysz pliku accelerator.yaml , repozytorium nadal działa jako akcelerator, ale pliki są przekazywane niezmodyfikowane użytkownikom. Aby uzyskać więcej informacji, zobacz sekcję Tworzenie pliku accelerator.yaml w akceleratorze aplikacji Tanzu Application Platform w wersji 1.5.

Następnie opublikuj nowy akcelerator.

Po utworzeniu pliku accelerator.yaml możesz utworzyć akcelerator. Następnie można go wyświetlić w witrynie Azure Portal lub na stronie Akcelerator aplikacji w portalu narzędzi deweloperskich. Nowy akcelerator można opublikować przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

W poniższej tabeli opisano pola akceleratora z możliwością dostosowywania:

Aby wyświetlić wszystkie opublikowane akceleratory, zobacz sekcję Akceleratory aplikacji na stronie Narzędzia deweloperskie. Wybierz adres URL akceleratora aplikacji, aby wyświetlić opublikowane akceleratory w portalu narzędzi deweloperskich:

Aby wyświetlić nowo opublikowany akcelerator, odśwież portal narzędzi deweloperskich.

Odwołaj się do fragmentu we własnych akceleratorach

Pisanie i utrzymywanie akceleratorów może stać się powtarzalne i rozległe w miarę dodawania nowych akceleratorów. Niektórzy ludzie tworzą nowe projekty, kopiując istniejące i wprowadzając modyfikacje, ale ten proces może być żmudny i podatny na błędy. Aby ułatwić tworzenie i konserwację akceleratorów, akcelerator aplikacji obsługuje funkcję o nazwie Composition , która umożliwia ponowne używanie części akceleratora, nazywanych fragmentami.

Aby odwołać się do fragmentu w akceleratorze, wykonaj następujące kroki:

1. Opublikuj nowy akcelerator typu Fragment przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

   • Portal Azure
   • Interfejs wiersza polecenia platformy Azure

   Aby utworzyć akcelerator fragmentu, otwórz sekcję Akceleratory , wybierz pozycję Dodaj akcelerator w sekcji Dostosowane akceleratory , a następnie wybierz pozycję Fragment.

   

2. Zmień plik accelerator.yaml w projekcie akceleratora. imports Użyj instrukcji w sekcji accelerator i instrukcji InvokeFragment w sekcji engine, aby odwołać się do fragmentu w akceleratorze, zgodnie z poniższym przykładem:

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. Zsynchronizuj zmianę z portalem narzędzi deweloperskich.

   Aby szybciej odzwierciedlić zmiany w portalu narzędzi deweloperskich, możesz podać wartość dla pola interwału Git dostosowanego akceleratora. Wartość interwału usługi Git wskazuje, jak często system sprawdza dostępność aktualizacji w repozytorium Git.

4. Zsynchronizuj zmianę z dostosowanym akceleratorem w witrynie Azure Portal przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

   • Portal Azure
   • Interfejs wiersza polecenia platformy Azure

   Na poniższej liście przedstawiono dwa sposoby synchronizowania zmian:

   • Utwórz lub zaktualizuj dostosowany akcelerator.
   • Otwórz sekcję Akceleratory , a następnie wybierz pozycję Synchronizuj certyfikat.

Aby uzyskać więcej informacji, zobacz Use fragments in Application Accelerator (Używanie fragmentów w akceleratorze aplikacji) w dokumentacji programu VMware.

Używanie akceleratorów do uruchamiania nowego projektu

Wykonaj następujące kroki, aby uruchomić nowy projekt przy użyciu akceleratorów:

1. Na stronie Narzędzia deweloperskie wybierz adres URL akceleratora aplikacji, aby otworzyć portal narzędzi deweloperskich.

   

2. W portalu narzędzi deweloperskich wybierz akcelerator.

3. Określ opcje wejściowe w sekcji Konfigurowanie akceleratora na stronie Generowanie akceleratorów.

   

4. Wybierz pozycję EKSPLORUJ PLIK , aby wyświetlić strukturę projektu i kod źródłowy.

5. Wybierz pozycję Przejrzyj i wygeneruj , aby przejrzeć określone parametry, a następnie wybierz pozycję Generuj akcelerator.

   

6. Następnie możesz wyświetlić lub pobrać projekt jako plik zip.

   

Konfigurowanie akceleratorów przy użyciu certyfikatu z podpisem własnym

Po skonfigurowaniu prywatnego repozytorium Git i włączeniu protokołu HTTPS przy użyciu certyfikatu z podpisem własnym należy skonfigurować nazwę certyfikatu urzędu certyfikacji do akceleratora na potrzeby weryfikacji certyfikatu klienta z akceleratora do repozytorium Git.

Wykonaj następujące kroki, aby skonfigurować akceleratory przy użyciu certyfikatu z podpisem własnym:

1. Zaimportuj certyfikaty do usługi Azure Spring Apps. Aby uzyskać więcej informacji, zobacz sekcję Importowanie certyfikatu w sekcji Używanie certyfikatów TLS/SSL w aplikacji w usłudze Azure Spring Apps.
2. Skonfiguruj certyfikat dla akceleratora przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

Obrót certyfikatów

Po wygaśnięciu certyfikatów należy wymienić certyfikaty w usłudze Spring Cloud Apps, wykonując następujące kroki:

1. Wygeneruj nowe certyfikaty przez zaufany urząd certyfikacji.
2. Zaimportuj certyfikaty do usługi Azure Spring Apps. Aby uzyskać więcej informacji, zobacz sekcję Importowanie certyfikatu w sekcji Używanie certyfikatów TLS/SSL w aplikacji w usłudze Azure Spring Apps.
3. Zsynchronizuj certyfikaty przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Akceleratory nie będą automatycznie używać najnowszego certyfikatu. Należy zsynchronizować jeden lub wszystkie certyfikaty przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

az spring application-accelerator customized-accelerator sync-cert \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name>

Zarządzanie przyspieszaczem aplikacji w istniejącej instancji planu korporacyjnego

Akcelerator aplikacji można włączyć w istniejącym wystąpieniu planu Azure Spring Apps Enterprise za pomocą portalu Azure lub interfejsu wiersza polecenia Azure.

az spring application-accelerator create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

az spring application-accelerator delete \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

Używanie akceleratora aplikacji w programie VS Code

Możesz rozpocząć projekt z dowolnego akceleratora aplikacji App Accelerator w planie Enterprise usługi Azure Spring Apps bezpośrednio w programie VS Code.

Wyświetlanie listy akceleratorów aplikacji

Wykonaj następujące kroki, aby wyświetlić listę akceleratorów aplikacji w wystąpieniu usługi planu Enterprise w usłudze Azure Spring Apps:

1. W programie Visual Studio Code otwórz rozszerzenie Azure Spring Apps, a następnie zaloguj się do konta platformy Azure.

2. Rozwiń odpowiednie wystąpienie usługi i kliknij prawym przyciskiem myszy, aby wybrać wystąpienie usługi.

3. Z menu wybierz pozycję Otwórz akcelerator aplikacji, aby otworzyć listę akceleratorów aplikacji. System wyświetla monit o zainstalowanie rozszerzenia Tanzu Application Accelerator dla programu Visual Studio Code, jeśli nie jest ono zainstalowane.

   

4. Wybierz dowolny akcelerator, aby uruchomić projekt.

   

Rozwiązywanie problemów z akceleratorem aplikacji

Jeśli spróbujesz otworzyć Akcelerator Aplikacji dla wystąpienia usługi, które nie włączyło Akceleratora Aplikacji lub nie uwidoczniono publicznego punktu końcowego, zostanie wyświetlony następujący komunikat o błędzie: Application Accelerator of Spring Apps <instance-name> is not enabled or publicly accessible.

Aby włączyć akcelerator aplikacji i uwidocznić publiczne punkty końcowe, wykonaj następujące kroki. Aby uzyskać więcej informacji, zobacz sekcję Zarządzaj akceleratorem aplikacji w istniejącym wystąpieniu planu przedsiębiorstwa.

1. Jeśli włączono logowanie jednokrotne w portalu narzędzi deweloperskich, podczas uzyskiwania dostępu do rozszerzenia zostanie wyświetlony następujący komunikat: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Aby uzyskać więcej informacji, zobacz sekcję Konfigurowanie portalu narzędzi deweloperskich w temacie Konfigurowanie narzędzi Tanzu Dev Tools w planie Azure Spring Apps Enterprise.

2. Wybierz pozycję Zezwalaj, wybierz pozycję Otwórz, a następnie wybierz pozycję Otwórz ponownie, aby otworzyć listę rozszerzeń programu VS Code.

   

Czasami może zostać wyświetlony komunikat o błędzie podobny do następującego przykładu: AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

Aby rozwiązać ten problem, dodaj identyfikator URI vscode://VMware.tanzu-app-accelerator przekierowania do odpowiedniego dostawcy tożsamości (IdP). W usłudze Microsoft Entra ID przejdź do menu Uwierzytelnianie i dodaj identyfikatory URI przekierowania do aplikacji mobilnych i stacjonarnych w konfiguracjach platformy.

Następne kroki

• Azure Spring Apps