Eksplorowanie i dostosowywanie szablonu interfejsu wiersza polecenia dla deweloperów platformy Azure

W tym szybkim starcie zapoznasz się z szablonem CLI dewelopera Azure i dostosujesz go. Szablon hello-azd udostępnia prosty punkt wyjścia do tworzenia i wdrażania aplikacji na platformie Azure przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure (azd). Ten przewodnik szybkiego startu rozszerza pojęcia przedstawione w artykule Szybki start — wdrażanie szablonu azd.

Wymagania wstępne

Aby ukończyć ten szybki przewodnik w przeglądarce, będziesz potrzebował:

  • Dostęp do usługi GitHub Codespaces

Alternatywnie, aby ukończyć ten szybki start przy użyciu narzędzi lokalnych:

Eksplorowanie struktury szablonu interfejsu wiersza polecenia dla deweloperów platformy Azure

azd szablony to standardowe repozytoria kodu z dołączonymi dodatkowymi składnikami zawartości. Wszystkie azd szablony współdzielą podobną strukturę plików zgodnie z azd konwencjami.

  • infra folder — zawiera całą infrastrukturę Bicep lub Terraform jako pliki kodu szablonu azd. azd Wykonuje te pliki w celu utworzenia zasobów platformy Azure wymaganych przez aplikację.
  • src folder — zawiera kod źródłowy aplikacji. azd program pakuje i wdraża kod na podstawie konfiguracji w programie azure.yaml.
  • azure.yaml file — plik konfiguracji, który mapuje foldery kodu źródłowego w projekcie na zasoby platformy Azure zdefiniowane w folderze infra na potrzeby wdrożenia. Możesz na przykład zdefiniować usługę interfejsu API i usługę frontonu internetowego w osobnych folderach i zamapować je na różne zasoby platformy Azure na potrzeby wdrożenia.
  • .azure folder — zawiera podstawowe konfiguracje platformy Azure, takie jak lokalizacja wdrażania zasobów.

Na przykład większość azd szablonów jest zgodna z następującą strukturą folderów:

Zrzut ekranu przedstawiający strukturę szablonu interfejsu wiersza polecenia dla deweloperów platformy Azure.

Aby uzyskać więcej informacji na temat struktury , odwiedź artykuł azd.

Konfigurowanie przykładowego szablonu

hello-azd to przykładowy szablon zaprojektowany w celu zaprezentowania podstawowych funkcji azd , które można wdrożyć na platformie Azure przy użyciu jednego polecenia. Szablon udostępnia przyjazny interfejs użytkownika z informacjami na temat azd i małym narzędziem demonstracyjnym, które umożliwia przesyłanie i wyświetlanie biletów pomocy technicznej.

Szablon obsługuje następujące funkcje:

  • Pakuje i wdraża konteneryzowaną aplikację w usłudze Azure Container Apps
  • Tworzy zasoby platformy Azure wymagane przez aplikację, takie jak baza danych usługi Azure Cosmos DB
  • Można automatycznie skonfigurować potok ciągłej integracji/ciągłegoazd pipeline config wdrażania przy użyciu polecenia

Wykonaj następujące kroki, aby skonfigurować szablon:

  1. Otwórz repozytorium szablonów hello-azd w witrynie GitHub.

  2. Wybierz przycisk Kod , a następnie wybierz pozycję Codespaces.

  3. Utwórz nową przestrzeń kodu, aby uruchomić w pełni skonfigurowane środowisko programistyczne w przeglądarce. Prawdopodobnie będziesz musiał/-a zaczekać chwilę, aby środowisko się zainicjowało.

  4. Po załadowaniu środowiska Codespaces zainicjuj azdazd init szablon przy użyciu polecenia :

    azd init -t hello-azd

  5. Po wyświetleniu monitu wprowadź nazwę azd środowiska, na przykład helloazd.

Eksplorowanie szablonu

Po otwarciu szablonu w wybranym narzędziu możesz przeglądać strukturę folderów, aby dowiedzieć się, jak azd działają szablony:

  1. Rozwiń folder, src aby wyświetlić kod źródłowy aplikacji.

    • Szablon hello-azd zawiera konteneryzowaną aplikację .NET, która udostępnia prosty interfejs użytkownika umożliwiający poznanie azd przykładowych danych biletu i zarządzanie nimi. azd Obsługuje również inne języki, takie jak JavaScript i Python.
    • Po uruchomieniu azd upaplikacja zostanie spakowana jako obraz kontenera i wdrożona w usłudze Azure Container Apps.

  2. Rozwiń folder, infra aby eksplorować infrastrukturę jako pliki kodu.

    • Ten szablon używa plików Bicep (.bicep) do tworzenia zasobów platformy Azure, ale można również użyć narzędzia Terraform (.tf).

    • Plik main.bicep tworzy zasoby platformy Azure, odwołując się do innych modułów Bicep w folderze infra , takich jak konto usługi Azure Storage:

      // Omitted...

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
    name: 'storage'
    scope: rg
    params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
        {
        name: 'attachments'
        }
    ]
    }
}

// Omitted...

  3. W katalogu głównym szablonu otwórz azure.yaml plik, aby wyświetlić podstawowe konfiguracje szablonu:

    • Szablon definiuje jedną usługę o nazwie aca.

    • Konfiguracja aca usługi nakazuje azd spakowanie i wdrożenie kodu źródłowego w folderze w src aplikacji kontenera platformy Azure aprowizowanej przez wcześniej eksplorowane moduły Bicep.

    • Konfiguracje docker instruują azd pakowanie i wdrażanie aplikacji jako kontenera.

      metadata:
  template: hello-azd-dotnet  # Specifies the template being used
name: azd-starter  # Name of the project
services:
  aca:  # Define the Azure Container App service
    project: ./src  # Path to the source code
    language: csharp  # Programming language
    host: containerapp  # Hosting service
    docker:
      path: ./Dockerfile  # Location of the Dockerfile

Aktualizowanie szablonu

Możesz wprowadzić zmiany w szablonie, aby wpłynąć na wdrożona aplikacja i zasoby. W tym przykładzie wprowadzisz dwie małe zmiany w aplikacji i zapoznasz się z wdrożonymi wynikami:

  • Aktualizowanie tekstu powitalnego nagłówka aplikacji do własnej wiadomości
  • Zaktualizuj utworzone konto magazynu, aby utworzyć dwa kontenery obiektów blob zamiast jednego

Aby wprowadzić te zmiany, wykonaj następujące kroki:

  1. W folderze src > Components > Pages otwórz komponent Home.razor.

  2. Zastąp tekst nagłówka Hello, Azure Developer CLI! w górnej części strony innym komunikatem, takim jak Witaj, dostosowany szablon! i zapisz zmiany.

    <MudText Typo="Typo.h2" GutterBottom="true">Hello, customized template!</MudText>

  3. W folderze infra otwórz main.bicep plik.

  4. Znajdź blok kodu Bicep w okolicy wiersza 75, który tworzy konto magazynu i kontener blob.

    // Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      }
    ]
  }
}

    Zastąp kod następującym fragmentem kodu:

    // Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      },
      {
        name: 'archive'
      }
    ]
  }
}

Uruchamianie szablonu

Po wprowadzeniu zmian użyj azd up polecenia , aby aprowizować i wdrażać zasoby aplikacji:

  1. Otwórz terminal w katalogu projektu.

  2. Aby aprowizować i wdrożyć szablon, uruchom azd up polecenie:

    azd up

    To polecenie spowoduje:

    • Pakowanie aplikacji do wdrożenia
    • Aprowizuj wymagane zasoby platformy Azure
    • Wdrażanie aplikacji przy użyciu zaktualizowanych zmian
    • Drukowanie adresu URL wdrożonej aplikacji

  3. Aby zobaczyć zaktualizowaną aplikację na żywo, otwórz adres URL wydrukowany w azd dziennikach wyjściowych konsoli w przeglądarce.

    Zrzut ekranu przedstawiający zaktualizowany nagłówek aplikacji.

  4. Aby wyświetlić dwa utworzone kontenery obiektów blob, przejdź do utworzonego konta magazynu w witrynie Azure Portal.

    Zrzut ekranu przedstawiający utworzone kontenery obiektów blob.

Podsumowanie

W tym szybkim przewodniku hello-azd poznasz strukturę szablonu, dostosujesz jego aplikację i infrastrukturę oraz wdrożysz go na platformie Azure przy użyciu interfejsu wiersza polecenia Azure Developer CLI. Aby uzyskać bardziej zaawansowane scenariusze, zapoznaj się z innymi szablonami lub zapoznaj się z dokumentacją azd .

Następne kroki

  • Ostatnia aktualizacja o