27
20

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

GithubActionsを試してみる

Posted at

8/8にβ版が一般公開されたので、情報整理のためにまとめてみました。

料金

現在公開されているβ版は無料で使えます。
パブリックリポジトリは無料、プライベートリポジトリは以下の通りみたいです

0626f4b787a219489921bc4eee69a418.png

セルフホストってなんでしょう…。環境一つもらえるってことなんですかね?

利用制限

無料で下記が使えます。

  • リポジトリごとに20のワークフローが使える
  • Github APIを1時間に1000回実行することができる
  • ワークフロー内のジョブは最大6時間まで動かせる
  • リポジトリごとに20のジョブを同時に実行することができる

CircleCIではジョブの同時実行が1つ(オープンソースプロジェクトは4)なので
とても太っ腹と思います。

利用方法

β版では利用登録をする必要があります。
Github Actions

筆者は8月中旬に申請して9月に使えるようになりました(白目)
使えるようになると、メールが来て、GithubのリポジトリにActionsが増えているはず…
image.png

利用できる仮想環境

CI上で利用できる環境は、Windows, MacOS, Linux全ての環境を1台無料で使用することができます。
Circle CIはMacOSとWindows環境は無料枠では制限があるので嬉しいですね。
(今後どうなるかはわかりませんが)

というのも、マトリックスビルドという複数の環境 × 複数のアプリでのビルドを売りにしているみたいです。

定義ファイルの書き方

YAMLで記述し、Github Actionsを使うリポジトリの.github/workflowsに配置します。

name

ワークフローに名前をつけることができます。

name: TEST_WORKFLOW_NAME

on

必須項目

Githubのイベントをトリガーします。
例えばpushしたとき、pull-requestを作成したとき、ですね。
詳細は以下にイベント一覧が載っています。
Events that trigger workflows | Github Help

# pushしたとき
on: [push]


### 複数指定も可能
on: [push, pull_request]

### ファイルやブランチ、タグの指定もできます
on: push
  branches:    # ブランチの指定(例ではmasterだけ)
  - master
  tags:        # タグ指定
  - v1.0.1
  paths:       # ファイル指定。正規表現も使える
  - 'src/*'
  - '*.java'

### ワークフローにはスケジューリングもできる
on: push
  schedule:
  - cron:  '*/15 * * * *' # *を含む場合にはシングルクォートで囲む

jobs

必須項目
job.<job.id>で各ジョブを指定します。

jobs:
  api_test:
    name: API Test Job         # 名前もつけられます。
  ui_test:
    name: UI Test Job
  ui_build:
    name: UI Build Job
    needs: ui_test              # 起動するために必要なジョブを指定
  deploy:
    name: Deploy Step
    needs: [api_test, ui_build] # 複数指定可
## こんなワークフローになります。
api_test --->-------------> deploy
ui_test ----> ui_build ---┘
jobs.<job_id>.runs-on

必須項目
ジョブがどの仮想環境で動くかを指定できます。

jobs:
  api_test:
    name: API Test Step 
  runs-on: ubuntu-latest

Virtual environments for GitHub Actions | Guthub Helps

jobs.<job_id>.container

コンテナが指定できます。

jobs:
  ui_test:
    name: UI Test Step
    container:
      image: node:latest
      volumes:
      - node_volume:/node_volume  # volumeマウントができる       
jobs.<job_id>.steps

タスクのステップを指定します。
name句, run句を指定して実際の処理を書いていきます。

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: Print Hello-World  # ステップの名前を指定する
      env:                     # 環境変数を指定できます
        PRINT: Hello-World
      run: |
        echo $PRINT

またusesを使うと、Github Actionsで定義されたステップを使うことができます。
例えば、actions/checkoutはGithubリポジトリのチェックアウトができます。
(Circle CIのorbのようなイメージ)

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master

使えるusesは以下から見ることができます。
GitHub Actions (リポジトリ)

しかし、useで使えるactionsはJSかDockerコンテナで作られているため、仮想環境はLinuxを使う必要があります。
jobs.<job_id>.steps.uses

jobs.<job_id>.services

ジョブの中で使えるコンテナを追加できます。
例えばテストで接続するDB環境やプロキシサーバのコンテナを立てられます。

下記例では、nginxとMySQLを立ててます

jobs:
  api_test:
    name: API Test Step 
  services:
    nginx:
      image: nginx
      ports:
      - 8080:80
      env:
        NGINX_PORT: 80
    test_db:
      image: mysql
      ports:
      - 3306:3306
      volumes: data:/db_volume
      env:
        MYSQL_DATABASE: test_app
        MYSQL_USER: hogehoge

試しに実行

build.yml
name: GithubActoinsTest
on: [push]

jobs:
  first_job:
    name: Initial Job
    runs-on: ubuntu-latest
    steps:
      - name: Github First Step
        uses: actions/checkout@master
      - run: echo All Done!
      - run: echo Test Artifact > test.txt
      - uses: actions/upload-artifact@master
        with:
          name: my-artifact
          path: test.txt

image.png

Artifact

Actionsのupload-artifactを使うと、アップロードも可能です。
image.png

気になること

  • ワークフロー間のデータ受け渡し
  • データのキャッシュ
  • 構文チェック

終わりに

Circle CI一強だったCIもGithubでできるようになるのは、他のサービスを跨がなくてもいいのはいいことですね。
ドキュメントがまだまだ少ないので、これから増えるといいなと思います。
11/13には一般公開なので、それまでに期待しましょう。

参考

Workflow syntax for GitHub Actions | Github Help

27
20
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
27
20

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?