■ はじめに

https://dk521123.hatenablog.com/entry/2021/11/04/142835

の続き。

今回は、ハンズオン的なことをやってみる。

【１】Github Actions の書き方

１）イメージ

* Githubイベントに応じて、Workflow (YAMLファイル)に掛かれたJobを実行していくだけ
 => Github Actions を身に着けることは、このWorkflowの書き方が分かればいいだけ。

Github Event ====> Workflow (.github/workflows/{WORKFLOW_NAME}.yml)
                   +-----------------------------------------------+
                   | workflow                                      |
                   | +-------------------------------------------+ |
                   | | job                                       | | => Runner (サーバで実行)
                   | +-------------------------------------------+ |
                   | +-------------------------------------------+ |
                   | | job                                       | | => Runner (サーバで実行)
                   | | +---------------------------------------+ | |
                   | | | step                                  | | |
                   | | +---------------------------------------+ | |
                   | | +---------------------------------------+ | |
                   | | | step                                  | | |
                   | | +---------------------------------------+ | |
                   | +-------------------------------------------+ |

【２】Hello world

https://docs.github.com/ja/actions/quickstart

に載っている Quick Start をやってみる。

１）手順

* 適当なリポジトリで以下を行う。

[1] Githubにアクセスし [Actions]を選択
[2] 「Simple workflow」内の「Set up this workflow」ボタン押下
[3] ファイル名「github-actions-demo.yml」にし、
　以下のサンプルを参考にYAMLファイルの内容を改変する
[4] 「Start Commit」ボタン押下
 => 後は、流れで、YAMLファイルをコミットしていく

github-actions-demo.yml

# This is a basic workflow to help you get started with Actions

name: CI

# Controls when the workflow will run
on:
  # Triggers the workflow on push or pull request events but only for the develop branch
  push:
    branches: [ develop ]
  pull_request:
    branches: [ develop ]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build:
    # The type of runner that the job will run on
    runs-on: ubuntu-latest

    # Steps represent a sequence of tasks that will be executed as part of the job
    steps:
      - run: echo "The job was automatically triggered by a ${{ github.event_name }} event."
      - run: echo "This job is now running on a ${{ runner.os }} server hosted by GitHub!"
      - run: echo "The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."
      - run: echo "This job's status is ${{ job.status }}."

      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
      - uses: actions/checkout@v4

      # Runs a single command using the runners shell
      - name: Run a one-line script
        run: echo Hello, world!

      # Runs a set of commands using the runners shell
      - name: Run a multi-line script
        run: |
          echo Add other actions to build,
          echo test, and deploy your project.

２）動作確認

[1] README.mdでもなんでもいいので、ソースを修正し、Commit & Push
[2] ブラウザで Github の該当のページを開き、 [Actions]を選択
 => 「X workflow runs」(X:数字 (e.g. 2))内で、
　　[1]のコミット内容をトリガーに実行されている

【３】actions/checkout@vX について

* Github Actionsでソースコードをcloneする

サンプル

  uses: actions/checkout@v4
        with:
          path: path/to/hello # <- 配下にクローンする

１）fetch-depth

* 0 は、全てのブランチ・タグの全ての履歴を取得することを意味する
* Default: 1 (最新のコミットのみを取得する)

ex. Fetch all history for all tags and branches
https://github.com/actions/checkout?tab=readme-ov-file#fetch-all-history-for-all-tags-and-branches

- uses: actions/checkout@v4
  with:
    fetch-depth: 0

２）ref

* ブランチ名を指定

ex. Checkout a different branch
https://github.com/actions/checkout?tab=readme-ov-file#checkout-a-different-branch

- uses: actions/checkout@v4
  with:
    ref: my-branch

３）repository

* リポジトリ名を指定

ex. Checkout multiple repos (side by side)
https://github.com/actions/checkout?tab=readme-ov-file#checkout-multiple-repos-side-by-side

- name: Checkout
  uses: actions/checkout@v4
  with:
    path: main

- name: Checkout tools repo
  uses: actions/checkout@v4
  with:
    repository: my-org/my-tools
    path: my-tools

４）path

* リポジトリをどのパスに落とすか

ex. Checkout multiple repos (private)
https://github.com/actions/checkout?tab=readme-ov-file#checkout-multiple-repos-private

- name: Checkout
  uses: actions/checkout@v4
  with:
    path: main

- name: Checkout private tools
  uses: actions/checkout@v4
  with:
    repository: my-org/my-private-tools
    token: ${{ secrets.GH_PAT }} # `GH_PAT` is a secret that contains your PAT
    path: my-tools

５）filter

* フィルタリング機能
* Default: null

プログラムの超個人的なメモ

Memo for Programming.

【Github】Github Actions ～入門編～

■ はじめに

目次

【１】Github Actions の書き方

１）イメージ

【２】Hello world

１）手順

２）動作確認

【３】actions/checkout@vX について

１）fetch-depth

２）ref

３）repository

４）path

５）filter

関連記事