Cvičení – nastavení prostředí

Dokončeno

Tým pomalu integroval strategii DevOps do svých procesů. V této části se ujistěte, že vaše prostředí odráží dosavadní úsilí týmu.

Uděláte to takto:

  • Přidejte uživatele, aby se Azure DevOps mohl připojit k vašemu předplatnému Azure.
  • Nastavte pro tento modul projekt Azure DevOps.
  • Přidejte kanál buildu.

Přidání uživatele do Azure DevOps

K dokončení tohoto modulu potřebujete vlastní předplatné Azure. S Azure můžete začít zdarma.

I když k práci s Azure DevOps nepotřebujete předplatné, použijete Azure DevOps k nasazení do prostředků Azure, které existují ve vašem předplatném Azure. Pokud chcete tento proces zjednodušit, přihlaste se ke svému předplatnému Azure i organizaci Azure DevOps pod stejným účtem Microsoft.

Pokud k přihlášení k Azure a Azure DevOps používáte různé účty Microsoft, přidejte uživatele do organizace DevOps pod účet Microsoft, který používáte pro přihlášení k Azure. Další informace najdete v tématu Přidání uživatelů organizace a správa přístupu. Když přidáte uživatele, zvolte úroveň základního přístupu.

Pak se odhlaste z Azure DevOps a znovu se přihlaste pod účtem Microsoft, který používáte k přihlášení ke svému předplatnému Azure.

Získání projektu Azure DevOps

Ujistěte se, že je vaše organizace Azure DevOps nastavená tak, aby dokončila zbytek tohoto modulu. Uděláte to spuštěním šablony, která pro vás v Azure DevOps vytvoří projekt.

Moduly v tomto studijním programu tvoří průběh při sledování webového týmu Tailspin prostřednictvím své cesty DevOps. Pro účely výuky má každý modul přidružený projekt Azure DevOps.

Spustit šablonu

Spuštění šablony, která nastaví ve vaší organizaci Azure DevOps vše za vás

Na webu Azure DevOps Demo Generator spusťte šablonu následujícím postupem:

  1. Vyberte Přihlásit se a přijměte podmínky použití.

  2. Na stránce Vytvořit nový projekt vyberte svoji organizaci Azure DevOps a zadejte název projektu, například Space Game – web – Vydání.

    Screenshot of the Azure DevOps Demo Generator web site showing the process to create the project.

  3. Vyberte Ano, chci vytvořit fork tohoto úložiště>Autorizovat. Pokud se zobrazí okno, autorizujte přístup k vašemu účtu GitHub.

    Důležité

    Tuto možnost musíte vybrat, aby se šablona připojila k úložišti GitHub. Vyberte ho i v případě, že jste už rozvětvovali projekt webu Space Game . Šablona použije existující fork.

  4. Vyberte Vytvořit projekt. Spuštění šablony chvíli trvá.

  5. Výběrem možnosti Přejít na projekt přejdete do projektu v Azure DevOps.

Důležité

Stránka o vyčištění prostředí Azure DevOps v tomto modulu obsahuje důležité kroky pro vyčištění. Vyčištěním pomůžete zajistit, abyste nevyčerpali bezplatné minuty sestavení. Postup pro vyčištění proveďte i v případě, že tento modul nedokončíte.

Nastavení viditelnosti projektu

Na začátku je váš fork úložiště Space Game na GitHubu nastavený na veřejný, zatímco projekt vytvořený šablonou Azure DevOps je nastavený na privátní. K veřejnému úložišti na GitHubu může přistupovat kdokoli, zatímco soukromé úložiště je přístupné jenom vám a lidem, se kterými ho chcete sdílet. Podobně veřejné projekty v Azure DevOps poskytují přístup jen pro čtení neověřených uživatelům, zatímco soukromé projekty vyžadují, aby měli uživatelé udělený přístup a ověřili přístup ke službám.

V tuto chvíli není nutné upravovat žádná z těchto nastavení pro účely tohoto modulu. U vašich osobních projektů však musíte určit viditelnost a přístup, který chcete udělit ostatním. Pokud je váš projekt například opensourcový, můžete se rozhodnout, že své úložiště GitHub i projekt Azure DevOps zveřejníte. Pokud je váš projekt proprietární, obvykle byste své úložiště GitHub i projekt Azure DevOps mohli nastavit jako soukromé.

Později můžete najít následující zdroje informací, které vám pomůžou určit, která možnost je pro váš projekt nejvhodnější:

Příprava Visual Studio Code

Nastavte Visual Studio Code, abyste mohli web sestavit místně a používat zdrojové soubory.

Visual Studio Code se dodává s integrovaným terminálem, abyste mohli upravovat soubory a pracovat z příkazového řádku, a to vše na jednom místě.

  1. Spusťte Visual Studio Code.

  2. Vyberte Terminál a pak vyberte Nový terminál.

  3. V rozevíracím seznamu vyberte Git Bash. Pokud znáte jiné prostředí unixu, které raději používáte, například Zsh, vyberte místo toho toto prostředí. Git pro Windows obsahuje Git Bash, které umožňuje snadno spouštět příkazy Gitu.

    Poznámka:

    Pokud ve Windows nevidíte Git Bash uvedený jako možnost, ujistěte se, že jste nainstalovali Git, a restartujte Visual Studio Code.

  4. Spuštěním následujícího příkazu přejděte do svého domovského adresáře.

    cd ~
    

Konfigurace Gitu

Pokud s Gitem a GitHubem teprve začínáte, musíte nejdřív spustit několik příkazů, abyste přidružili svoji identitu k Gitu a ověřili se pomocí GitHubu. Další informace najdete v tématu Nastavení Gitu.

Minimálně budete muset provést následující kroky:

  1. Stáhněte a nainstalujte nejnovější verzi Gitu.
  2. Nastavte své uživatelské jméno.
  3. Nastavte e-mailovou adresu potvrzení.

Poznámka:

Pokud už s GitHubem používáte dvojúrovňové ověřování, vytvořte osobní přístupový token. Token použijte místo hesla, až se zobrazí výzva později.

S přístupovým tokenem zacházíte stejně jako s heslem. Udržujte ho na bezpečném místě.

Nastavení projektu v editoru Visual Studio Code

Když jste spustili šablonu pro nastavení projektu Azure DevOps, proces pro vás automaticky rozvětví úložiště mslearn-tailspin-spacegame-web-deploy . Teď si stáhnete nebo naklonujete kopii do počítače, abyste s ní mohli pracovat.

Místní klonování forku

  1. Na GitHubu přejděte na fork webového projektu Space Game (mslearn-tailspin-spacegame-web-deploy).

  2. Vyberte Kód a pak na kartě HTTPS vyberte tlačítko kopírovat a zkopírujte adresu URL do schránky.

    Screenshot that shows how to locate the URL and copy button from the GitHub repository.

  3. V editoru Visual Studio Code přejděte do okna terminálu, které jste otevřeli dříve.

  4. Spusťte příkaz git clone. Nahraďte adresu URL zobrazenou tady obsahem schránky:

    git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git
    
  5. Přejděte do adresáře mslearn-tailspin-spacegame-web-deploy . Tento adresář je kořenem vašeho úložiště.

    cd mslearn-tailspin-spacegame-web-deploy
    

Nastavení upstreamového vzdáleného úložiště

Vzdálené je úložiště Git, ve kterém členové týmu spolupracují (například úložiště na GitHubu). Tady zobrazíte seznam vzdálených zařízení a přidáte vzdálený odkaz, který odkazuje na kopii úložiště Microsoftu, abyste mohli získat nejnovější ukázkový kód.

  1. Spuštěním následujícího příkazu zobrazte seznam vzdálených zařízení:

    git remote -v
    

    Uvidíte, že máte k úložišti přístup k načtení (stažení) i nahrání (nahrání):

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
    

    Origin určuje vaše úložiště na GitHubu. Když forkujete kód z jiného úložiště, původní vzdálený (ten, ze které jste forkovali) se běžně nazývá upstream.

  2. Spuštěním následujícího příkazu vytvořte vzdálený pojmenovaný upstream , který odkazuje na úložiště Microsoftu:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git
    
  3. Spusťte git remote podruhé, abyste viděli změny:

    git remote -v
    

    Uvidíte, že máte ve svém úložišti stále přístup k načítání (stahování) a sdílení změn (nahrávání). Teď máte také přístup z úložiště Microsoftu:

    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
    origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
    upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)
    upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (push)
    

Otevření projektu v editoru Visual Studio Code

  1. Z kořenového adresáře projektu spusťte následující příkaz.

    code .
    
  2. Znovu otevřete integrovaný terminál. Terminál vás umístí do kořenového adresáře webového projektu.

Pokud se code příkaz nezdaří, musíte do systémové CESTY přidat Visual Studio Code. Postup:

  1. V editoru Visual Studio Code vyberte F1 nebo vyberte Zobrazit>paletu příkazů pro přístup k paletě příkazů.
  2. Zadejte příkaz shellu a najděte příkaz Shell: Nainstalujte v příkazu PATH příkaz code.
  3. Restartujte terminál, aby se nová CESTA projevila.

Teď jste nastavili, abyste mohli pracovat se zdrojovým kódem Space Game a konfigurací Služby Azure Pipelines z místního vývojového prostředí.

Načtení větve z GitHubu

  1. V editoru Visual Studio Code otevřete integrovaný terminál.

  2. Spuštěním následujících příkazů načtěte větev kanálu verze z úložiště MicrosoftDocs a podívejte se na novou větev upstream/release-pipeline.

    git fetch upstream release-pipeline
    git checkout -B release-pipeline upstream/release-pipeline
    
  3. Jako volitelný krok otevřete v editoru Visual Studio Code soubor azure-pipelines.yml a seznamte se s počáteční konfigurací kanálu YAML.

Spuštění kanálu

V tuto chvíli máte:

  • Fork úložiště mslearn-tailspin-spacegame-web-deploy ve vašem účtu GitHubu
  • Místně naklonované úložiště mslearn-tailspin-spacegame-web-deploy.
  • Větev s názvem release-pipeline , která obsahuje zdrojový kód webu a počáteční konfiguraci Azure Pipelines.

V dalším kroku ručně aktivujete spuštění kanálu. Tento krok zajistí, že je projekt nastavený tak, aby se sestavil z úložiště GitHub. Počáteční konfigurace kanálu sestaví aplikaci a vytvoří artefakt sestavení.

  1. Přejděte do svého projektu v Azure DevOps a pak vyberte Pipelines.

  2. Vyberte kanál mslearn-tailspin-spacegame-web-deploy. Pokud se zobrazí výzva, ujistěte se, že jste vybrali Autorizovat prostředky pro autorizaci připojení služby.

    Screenshot of Azure Pipelines showing the pipeline for this project. The pipeline has no runs.

  3. Vyberte Spustit kanál a potom v rozevírací nabídce Branch/tag (Větev/značka) vyberte větev kanálu verze. Vyberte Spustit.

    Screenshot of Azure Pipelines showing the location of the Run pipeline button.

  4. Na stránce Souhrn vyberte úlohu kanálu a zobrazte protokoly.

    Screenshot of Azure Pipelines showing the running job.

  5. Po dokončení sestavení se výběrem tlačítka Zpět vraťte na stránku souhrnu.

    Screenshot of Azure Pipelines showing how to navigate to the summary page.

  6. Vyberte publikovaný artefakt.

    Screenshot of Azure Pipelines showing the location of the link to the published artifact.

  7. Tailspin.Space.Game.Web.zip je artefaktem sestavení. Tento soubor obsahuje vytvořenou aplikaci a její závislosti.

    Screenshot of Azure Pipelines showing the published artifact. The artifact includes a .zip file.

Teď máte kanál buildu pro webový projekt Space Game. Dále přidáte fázi nasazení pro nasazení artefaktu sestavení do služby Aplikace Azure Service.