Poznaj przepływy inicjalizacji narzędzia Azure Developer CLI

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) udostępnia zestaw poleceń usprawniających opracowywanie, aprowizowanie i wdrażanie aplikacji na platformie Azure. Polecenie azd init ułatwia skonfigurowanie nowych lub istniejących projektów przez wygenerowanie plików i konfiguracji wymaganych do pracy z azdprogramem . W tym artykule opisano różne dostępne przepływy pracy inicjowania i sposób wybierania najlepszej opcji dla scenariusza programowania.

Przepływy pracy inicjowania

Polecenie azd init obsługuje kilka przepływów pracy, aby przygotować aplikację do pracy z usługą azd:

  • Konfigurowanie przy użyciu usługi GitHub Copilot (podgląd): uruchamia dedykowaną sesję agent funkcji Copilot, która może planować projekt, generować zasoby szablonu i weryfikować wynik.
  • Skanuj bieżący katalog: analizuje istniejącą bazę kodu aplikacji w celu wygenerowania odpowiednich azd plików konfiguracji i zasobów.
  • Wybierz szablon: Klonuje i inicjuje azd szablon z galerii szablonów.
  • Tworzenie minimalnego projektu: inicjuje podstawowy azure.yaml plik jako punkt wyjścia do tworzenia własnego azd szablonu od podstaw.

Aby utworzyć szablon, użyj polecenia Konfigurowanie przy użyciu usługi GitHub Copilot (podgląd). Aby zapoznać się z omówieniem pełnego cyklu życia tworzenia, zobacz Omówienie tworzenia szablonów. W poniższych sekcjach opisano każdy przepływ pracy inicjowania.

Konfigurowanie przy użyciu usługi GitHub Copilot (podgląd)

Użyj tego przepływu pracy, aby utworzyć szablon z pomocą sztucznej inteligencji. azdUruchamia dedykowaną sesję usługi GitHub agent funkcji Copilot, która może sprawdzić istniejące pliki projektu lub ułatwić zaplanowanie nowego projektu. Agent generuje standardowe zasoby azd, takie jak azure.yaml, pliki Bicep lub Terraform oraz konfiguracje kontenerów, a następnie weryfikuje wynik.

Sesja agenta jest uruchamiana w terminalu i nie kontynuuje aktywnej sesji usługi GitHub Copilot Chat z Visual Studio Code. Aby uzyskać wymagania wstępne i szczegółowe instrukcje, zobacz Rozpoczynanie pracy z nowym szablonem.

Skanuj bieżący katalog

Użyj tego przepływu pracy, gdy masz istniejącą bazę kodu aplikacji i chcesz przygotować ją do wdrożenia na platformie Azure przy użyciu polecenia azd.

  1. Przejdź do katalogu głównego projektu.

  2. Uruchom polecenie azd init.

    azd init

  3. Wybierz pozycję Skanuj bieżący katalog. azd będzie:

    • Przeskanuj katalog, aby określić język lub strukturę używaną przez aplikację.
    • Wybierz odpowiednią platformę hostingu, taką jak Azure Container Apps.
    • W razie potrzeby poproś o dodanie lub usunięcie wykrytych usług.
    ? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

  4. Wybierz pozycję Potwierdź i kontynuuj inicjowanie aplikacji , aby ukończyć przepływ pracy. azd tworzy następujące elementy w katalogu aplikacji:

    • Plik azure.yaml, który definiuje usługi aplikacji i przyporządkowuje je do zasobów hostingu.
    • .azure folder służący do przechowywania ustawień konfiguracji, takich jak nazwa środowiska.
    • .gitignore Plik skonfigurowany dla języka aplikacji i platformy hostingu.

  5. Opcjonalnie uruchom polecenie azd up , aby utworzyć zasoby usługi Azure Container Apps i wdrożyć aplikację.

Twoja aplikacja jest teraz ustrukturyzowana jako azd szablon, który można nadal opracowywać i rozszerzać przy użyciu większej liczby zasobów i usług platformy Azure.

Wybieranie szablonu

Ten przepływ pracy umożliwia rozpoczęcie od wstępnie utworzonego azd szablonu, który zwykle zawiera zarówno kod aplikacji, jak i niezbędne definicje infrastruktury platformy Azure.

  1. azd init Uruchom polecenie:

    azd init

    Uwaga / Notatka

    Możesz również uruchomić azd init z parametrem --template aby bezpośrednio zainicjować szablon przez nazwę i pominąć wybór procesu pracy.

  2. Wybierz Wybierz szablon. azd Wyświetla listę dostępnych szablonów ze skonfigurowanych źródeł szablonów.

    ? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

  3. Wpisz, aby przefiltrować wyniki i znaleźć szablon Hello AZD. Wybierz szablon, aby go sklonować i zainicjalizować.

  4. Opcjonalnie uruchom polecenie azd up , aby aprowizować i wdrożyć zasoby szablonu na platformie Azure.

Możesz również użyć zainicjowanego szablonu jako punktu wyjścia do dalszego programowania.

Tworzenie minimalnego projektu

W przypadku zaawansowanych użytkowników, którzy chcą rozpocząć od minimalnej konfiguracji i dostosować wszystko ręcznie, ta opcja zapewnia tylko podstawową konfigurację.

  1. azd init Uruchom polecenie z flagą --minimal :

    azd init --minimal

  2. Po wyświetleniu monitu wprowadź nazwę azd szablonu i wybierz klawisz Enter.

    ? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.

    Flaga --minimal tworzy tylko następujące elementy:

    • Podstawowy azure.yaml plik o nazwie projektu
    • .azure Katalog konfiguracji środowiska
    • Plik .gitignore z odpowiednimi wpisami dla Azure Developer CLI

    Ta usprawniona inicjalizacja jest idealna, gdy:

    • Chcesz utworzyć infrastrukturę od podstaw
    • Konieczność integracji azd z istniejącym złożonym projektem
    • Preferuj pełną kontrolę nad strukturą projektu

  3. Ukończ konfigurację projektu. Możesz ręcznie utworzyć pliki infrastruktury w folderze infra , poprosić agenta kodowania sztucznej inteligencji o utworzenie infrastruktury i dostosować azure.yaml je do definiowania usług i zasobów.

Nazewnictwo zasobów projektu i platformy Azure

Podczas inicjowania nowego lub istniejącego projektu nazwa projektu jest ustawiona na .azure.yaml Nazwa projektu działa jako prefiks nazw zasobów platformy Azure utworzonych podczas procesu aprowizacji. Przestrzegając reguł walidacji, upewnij się, że wygenerowane nazwy zasobów platformy Azure będą również prawidłowe.

W szablonach Bicep lub Terraform nazwa projektu jest często używana jako podstawa do konstruowania nazw zasobów w połączeniu z nazwą środowiska i innymi elementami. Przykład:

var resourceToken = '${name}-${environmentName}'

Gdzie name odwołuje się do nazwy projektu i environmentName jest nazwą azd środowiska.

Reguły sprawdzania poprawności nazw projektów

Podczas inicjowania azd init projektu lub podczas tworzenia nowej nazwy projektu w azure.yaml pliku są stosowane następujące reguły sprawdzania poprawności:

Reguła Description
Dozwolone znaki Nazwy projektów mogą zawierać tylko małe litery, cyfry i łączniki.
Znak początkowy Nazwy projektów muszą zaczynać się literą.
Znak końcowy Nazwy projektów nie mogą kończyć się łącznikiem.
Długość Nazwy projektów muszą mieć długość od 2 do 63 znaków.
Brak kolejnych łączników Nazwy projektów nie mogą zawierać kolejnych łączników.

Te reguły walidacji zapewniają, że nazwa projektu będzie zgodna z wymaganiami dotyczącymi nazewnictwa zasobów platformy Azure i zapobiegnie niepowodzeniu tworzenia pakietów usług podczas wdrażania.

Dalsze kroki

Po zainicjowaniu projektu za pomocą azd initpolecenia można wykonać następujące czynności:

  • Zmodyfikuj wygenerowane pliki infrastruktury, aby dostosować zasoby platformy Azure.
  • Użyj azd provision polecenia , aby utworzyć wymagane zasoby na platformie Azure.
  • Użyj polecenia azd deploy , aby wdrożyć kod aplikacji w aprowizowanych zasobach.
  • Dowiedz się więcej o przepływie pracy Azure Developer CLI w celu połączenia przydziału zasobów i wdrażania w jednym poleceniu.

Treści powiązane

  • Last updated on