Cvičení – vytvoření a spuštění základního pracovního postupu

Dokončeno

Důležité

K provedení tohoto cvičení potřebujete vlastní předplatné Azure a mohou se vám účtovat poplatky. Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet, než začnete.

Chcete automatizovat nasazení aktualizací na web vaší společnosti. Jako první krok vytvoříte základní pracovní postup v GitHub Actions.

V tomto cvičení:

• Vytvořte účet a úložiště GitHub.
• Vytvořte základní pracovní postup.
• Spusťte základní pracovní postup.

Vytvoření úložiště na GitHubu

1. V prohlížeči přejděte na GitHub. Přihlaste se pomocí svého účtu GitHub nebo si vytvořte nový účet, pokud ho nemáte.

2. V pravém horním rohu okna vyberte ikonu plus (+) a pak vyberte Nové úložiště.

   

3. Zadejte podrobnosti o novém úložišti:

   • Vlastník: V rozevírací nabídce vyberte své uživatelské jméno GitHubu. Na snímku obrazovky mygithubuser je název účtu GitHub vlastníka úložiště. Název účtu použijete později v tomto modulu.
   • Název úložiště: Zadejte smysluplný, ale krátký název. Pro tento modul použijte toy-website-workflow.
   • Popis: Uveďte popis, který ostatním pomůže pochopit účel úložiště.
   • Soukromé: GitHub můžete použít k vytvoření veřejných a privátních úložišť. Vytvořte privátní úložiště, protože k souborům vašeho webu by měli přistupovat jenom lidé z vaší organizace. Později můžete ostatním udělit přístup.

   Po dokončení by konfigurace úložiště měla vypadat jako na následujícím snímku obrazovky:

   

4. Vyberte Create repository (Vytvořit úložiště).

Klonování úložiště

V editoru Visual Studio Code naklonujte úložiště.

1. Na stránce úložiště vyberte tlačítko kopírování a zkopírujte adresu URL do úložiště Git.

   

2. Otevřete Visual Studio Code.

3. Výběrem možnosti Terminálový>nový terminál otevřete okno terminálu editoru Visual Studio Code. Okno se obvykle otevře v dolní části obrazovky.

4. V terminálu přejděte do adresáře, do kterého chcete naklonovat úložiště GitHub na místním počítači. Pokud chcete například naklonovat úložiště do složky toy-website-workflow , spusťte následující příkaz:

   cd toy-website-workflow
   

5. Zadejte git clone a vložte dříve zkopírovanou adresu URL, která vypadá přibližně takto:

   git clone https://github.com/mygithubuser/toy-website-workflow
   

   Zobrazí se upozornění, že jste naklonovali prázdné úložiště. Zprávu můžete ignorovat.

6. Toto je poprvé, co jste použili toto úložiště, takže se může zobrazit výzva k přihlášení.

   Ve Windows zadejte 1 pro ověření pomocí webového prohlížeče a vyberte Enter.

   V systému macOS vyberte Autorizovat.

7. Zobrazí se okno prohlížeče. Možná se budete muset znovu přihlásit k GitHubu. Vyberte Autorizovat.

8. Znovu otevřete Visual Studio Code ve složce úložiště spuštěním následujícího příkazu:

   code -r toy-website-workflow
   

Tip

Definice pracovních postupů GitHub Actions můžete také upravit pomocí webového uživatelského rozhraní GitHubu. Když otevřete definici pracovního postupu, GitHub vám pomůže se syntaxí souboru YAML a odsazením a poskytuje ukázkové fragmenty kódu pro akce, které můžete chtít použít. V tomto modulu budete pracovat s definičním souborem v editoru Visual Studio Code, ale můžete prozkoumat editor GitHubu a podívat se, jak funguje.

Vytvoření definice pracovního postupu YAML

Teď, když jste vytvořili a naklonovali úložiště, jste připraveni vytvořit základní definici pracovního postupu.

1. V editoru Visual Studio Code otevřete Průzkumníka.

2. V kořenovém adresáři struktury složek toy-website-workflow vytvořte novou složku s názvem .github.

   Poznámka:

   Ujistěte se, že jste na začátku názvu složky zahrnuli tečku. To znamená, že se jedná o skrytou složku a GitHub vyžaduje, aby GitHub Actions zjistil definici pracovního postupu.

3. Ve složce .github vytvořte další složku s názvem pracovní postupy.

4. Ve složce pracovních postupů vytvořte nový soubor s názvem workflow.yml.

   

5. Zkopírujte do souboru následující definici pracovního postupu:

   name: deploy-toy-website
   
   on: [workflow_dispatch]
   
   jobs:
     say-hello:
       runs-on: ubuntu-latest
       steps:
         - name: 'placeholder step'
           run: echo "Hello world!"
   

6. Uložte soubor.

7. Potvrďte a nasdílejte soubor do úložiště GitHub pomocí následujících příkazů:

   git add .
   git commit -m "Add initial workflow definition"
   git push
   

Tip

Visual Studio Code vám pomůže s odsazením souboru YAML. Prohlédněte si vlnovky, které označují chyby syntaxe, nebo vyberte Zobrazit>problémy a zobrazte seznam problémů v souboru.

Spuštění pracovního postupu

Vytvořili jste definici pracovního postupu. GitHub Actions automaticky rozpozná váš soubor pracovního postupu, protože se nachází v adresáři .github/workflows .

1. V prohlížeči přejděte do úložiště. Možná budete muset stránku aktualizovat, aby se změny zobrazily.

2. Vyberte kartu Akce.

   

3. Vyberte pracovní postup webu deploy-toy-website.

   

4. Vyberte rozevírací seznam Spustit pracovní postup a pak vyberte tlačítko Spustit pracovní postup.

   

5. Pracovní postup se začne spouštět. Může to chvíli trvat a můžete aktualizovat stránku, ale měla by se automaticky aktualizovat a zobrazit, že je spuštěný nebo spuštěný nebo dokonce dokončený pracovní postup.

   

   Všimněte si, že stav spuštění se zpočátku zobrazuje jako zařazený do fronty. Spuštění pracovního postupu může nějakou dobu trvat. Vaše úloha se přidá do fronty pro spouštěč a jakmile je spouštěč dostupný, GitHub Actions přiřadí spouštěč a spustí úlohu. Stav úlohy se pak stane Spuštěno.

   Každé spuštění pracovního postupu obsahuje identifikátor. Tento identifikátor můžete použít, když potřebujete odkazovat na spuštění pracovního postupu a najít konkrétní spuštění pracovního postupu.

Ověření spuštění pracovního postupu

1. Po spuštění pracovního postupu vyberte web deploy-toy-website a zobrazte podrobnosti o spuštění. Aktualizujte stránku, dokud stav úlohy nezobrazí úspěch.

   

   Všimněte si také, že stránka obsahuje identifikátor potvrzení Gitu, které se použilo. Identifikátor potvrzení označuje verzi obsahu úložiště, kterou pracovní postup použil.

2. V seznamu úloh vyberte say-hello.

   

3. Zobrazí se stránka s informacemi o úloze, která zobrazuje protokol kroků, které pracovní postup spustil za vás. Všimněte si, že je součástí vašeho zástupného kroku .

   

   Všimněte si, že seznam obsahuje kroky, které jste nezadali. Tyto kroky automaticky vytvoří GitHub Actions.

4. Vyberte zástupný krok.

   

   Protokoly pro tento krok zahrnují obsah příkazu, který byl zadán v souboru YAML vašeho pracovního postupu, a text Hello world! , který skript vygeneroval.

Propojení provádění pracovního postupu s potvrzením

Je dobré pochopit, jak křížově odkazovat na spuštění pracovního postupu na potvrzení obsaženého spuštění. Propojení provádění pracovního postupu s potvrzením vám může pomoct sledovat historii nasazení a diagnostikovat problémy.

1. Výběrem možnosti Souhrn se vrátíte do souhrnu spuštění.

2. Vyberte identifikátor potvrzení. GitHub zobrazí podrobnosti o potvrzení, které aktivovalo spuštění pracovního postupu.