# 目次
1. はじめに
2. GitHub Actionsの基本と条件付き実行
   - 2.1 GitHub Actionsとは
   - 2.2 条件付き実行の活用方法
3. 特定ディレクトリの変更のみCIを実行する方法
   - 3.1 `paths`フィルターの利用
   - 3.2 `if`条件を使用した制御
4. 実践例
   - 4.1 基本的な設定例
   - 4.2 実装方法
5. ベストプラクティス
6. まとめ

## 1. はじめに
GitHub Actionsは、リポジトリのさまざまなイベントに応じてCI/CDパイプラインを自動化するための強力なツールです。本記事では、特定のディレクトリ内の変更に対してのみGitHub Actionsを実行する方法を解説します。これにより、無駄なビルドやテストを避け、効率的なCIを実現できます。

## 2. GitHub Actionsの基本と条件付き実行

### 2.1 GitHub Actionsとは
GitHub Actionsは、ワークフローを定義して継続的な統合、ビルド、デプロイプロセスを自動化するためのサービスです。

### 2.2 条件付き実行の活用方法
特定のディレクトリやファイルが変更されたときにのみ、特定のジョブを実行可能にすることで、リソースの無駄を省くことができます。

## 3. 特定ディレクトリの変更のみCIを実行する方法

### 3.1 `paths`フィルターの利用
GitHub Actionsは`paths`フィルターを使って、特定のパスの変更にのみ反応するトリガーを設定できます。

![img](/mosaic-code.jpg)

この設定により、`src`ディレクトリ以下のファイルが変更された場合にのみ、ワークフローがトリガーされます。

### 3.2 `if`条件を使用した制御
更に柔軟に制御したい場合、`if`条件を使ってジョブの実行を制御できます。

![img](/mosaic-code.jpg)

## 4. 実践例

### 4.1 基本的な設定例
以下は、特定のディレクトリでの変更に基づく簡単なGitHub Actionsのセットアップ例です。

![img](/mosaic-code.jpg)

### 4.2 実装方法
- プッシュやプルリクエストのイベントごとに回避する設定やフィルターを定義し、最適化します。

## 5. ベストプラクティス
- `paths`と`paths-ignore`を組み合わせることで、必要な変更だけをトリガーにできます。
- 定期的に条件を見直し、プロジェクトの規模に応じて最適化してください。

## 6. まとめ
効率的なCI/CDパイプラインを構築することで、リソースを節約しつつ、プロジェクトの健全性を保てます。特定ディレクトリの変更のみGitHub Actionsを実行することで、必要なビルドとテストのみに集中でき、開発の短縮につながります。ぜひこれらのテクニックを試して、CIの効率向上を図ってください。 [cv:issue_marketplace_engineer]

# 目次
1. はじめに
2. GitHub Actionsの基本と条件付き実行
   - 2.1 GitHub Actionsとは
   - 2.2 条件付き実行の活用方法
3. 特定ディレクトリの変更のみCIを実行する方法
   - 3.1 `paths`フィルターの利用
   - 3.2 `if`条件を使用した制御
4. 実践例
   - 4.1 基本的な設定例
   - 4.2 実装方法
5. ベストプラクティス
6. まとめ

## 1. はじめに
GitHub Actionsは、リポジトリのさまざまなイベントに応じてCI/CDパイプラインを自動化するための強力なツールです。本記事では、特定のディレクトリ内の変更に対してのみGitHub Actionsを実行する方法を解説します。これにより、無駄なビルドやテストを避け、効率的なCIを実現できます。

## 2. GitHub Actionsの基本と条件付き実行

### 2.1 GitHub Actionsとは
GitHub Actionsは、ワークフローを定義して継続的な統合、ビルド、デプロイプロセスを自動化するためのサービスです。

### 2.2 条件付き実行の活用方法
特定のディレクトリやファイルが変更されたときにのみ、特定のジョブを実行可能にすることで、リソースの無駄を省くことができます。

## 3. 特定ディレクトリの変更のみCIを実行する方法

### 3.1 `paths`フィルターの利用
GitHub Actionsは`paths`フィルターを使って、特定のパスの変更にのみ反応するトリガーを設定できます。

```yaml
on:
  push:
    paths:
      - 'src/**'
```

この設定により、`src`ディレクトリ以下のファイルが変更された場合にのみ、ワークフローがトリガーされます。

### 3.2 `if`条件を使用した制御
更に柔軟に制御したい場合、`if`条件を使ってジョブの実行を制御できます。

```yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2

      - name: Run tests
        if: ${{ contains(github.event.head_commit.message, '[run-tests]') }}
        run: npm test
```

## 4. 実践例

### 4.1 基本的な設定例
以下は、特定のディレクトリでの変更に基づく簡単なGitHub Actionsのセットアップ例です。

```yaml
name: Example CI

on:
  push:
    paths:
      - 'docs/**'

jobs:
  example:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout source
      uses: actions/checkout@v2

    - name: Run a command
      run: echo "Changes detected in 'docs/' directory"
```

### 4.2 実装方法
- プッシュやプルリクエストのイベントごとに回避する設定やフィルターを定義し、最適化します。

## 5. ベストプラクティス
- `paths`と`paths-ignore`を組み合わせることで、必要な変更だけをトリガーにできます。
- 定期的に条件を見直し、プロジェクトの規模に応じて最適化してください。

## 6. まとめ
効率的なCI/CDパイプラインを構築することで、リソースを節約しつつ、プロジェクトの健全性を保てます。特定ディレクトリの変更のみGitHub Actionsを実行することで、必要なビルドとテストのみに集中でき、開発の短縮につながります。ぜひこれらのテクニックを試して、CIの効率向上を図ってください。 

目次

続きを読むには単価診断を受けてください（30秒）