🦉

GitHub Actions入門:初心者向けガイド

2023/09/18に公開

GitHub Actions入門:初心者向けガイド

イントロダクション

GitHub Actionsは、GitHub上で継続的インテグレーション(CI)と継続的デリバリー(CD)を行うためのサービスです。この記事ではGitHub Actionsの基本的な概念と使い方について解説します。

対象読者

  • GitHubを利用しているが、GitHub Actionsは未経験
  • CI/CDに興味があるが、どのツールを使って良いかわからない

GitHub Actionsの基本概念

GitHub Actionsを理解する前に、いくつかの基本用語を押さえましょう。

  • Workflow(ワークフロー): 一連の処理フローを定義する設定ファイル
  • Job(ジョブ): ワークフロー内で実行する個々のタスク
  • Step(ステップ): ジョブ内での小さな作業単位
  • Action(アクション): ステップで呼び出される再利用可能なコンポーネント

これらの用語は、GitHub Actionsの設定ファイル(通常は .github/workflows/*.yml)で頻繁に見かけます。

環境の準備

  1. GitHubアカウントの作成: まだアカウントを持っていない場合はこちらから作成できます。
  2. リポジトリの作成: 新しいリポジトリを作成または既存のリポジトリをクローンします。

最初のWorkflowを作成

Workflowを作成してみましょう。

  1. リポジトリ内で.github/workflowsディレクトリを作成します。
  2. その中にmy_first_workflow.ymlという名前のYAMLファイルを作成します。
  3. 以下のようなコードを追加します。
name: My First Workflow
on:
  push:
    branches:
      - main
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
      - name: Run tests
        run: echo "Running tests..."

この設定では、mainブランチにpushがあった際に、Ubuntu環境上でコードをチェックアウトし、テストを模倣するエコー文を実行します。

実行結果

よく使われるアクション

  • actions/checkout@v2: GitHubのリポジトリをチェックアウトする基本的なアクションです。
  • actions/setup-node@v2: Node.jsをセットアップするためのアクションです。
  • actions/cache@v2: 依存関係をキャッシュしてビルド時間を短縮するためのアクションです。

エラーとトラブルシューティング

GitHub Actionsの実行に問題が発生した場合、Actions タブからログを確認できます。ログにはエラーメッセージが詳細に出力されるため、そこから問題解決のヒントを得られます。

Tips & Tricks

  • マトリックスビルド: 複数のOSや言語バージョンでテストを行いたい場合、マトリックスビルドを使うと便利です。
  • シークレットの管理: 重要な環境変数は、GitHubの「Settings」から安全に管理できます。

まとめと次のステップ

この記事で、GitHub Actionsの基本的な使い方と設定方法について学びました。さらに詳しい情報はGitHub Actionsの公式ドキュメントで確認できます。

最後に

この記事が役に立ったと感じたら、是非ともシェアしてください!質問やコメントがあれば、お気軽にどうぞ!

Discussion