Create a Composite Action

​

Table of Contents

• Action Metadata Overview
• Use Case: Caching & Installing Dependencies
• Sample Workflow Before Refactoring
• Defining the Composite Action
• Using Your Composite Action
• Links and References

​

Action Metadata Overview

• name: Visual identifier
• description: Short summary
• inputs/outputs (optional): Dynamic parameters
• runs: Runtime configuration

branding:
  icon: 'award'
  color: 'green'

​

Use Case: Caching & Installing Dependencies

1. Checkout repository
2. Set up Node.js
3. Cache NPM dependencies
4. Install dependencies

​

Sample Workflow Before Refactoring

jobs:
  unit-testing:
    name: Unit Testing
    runs-on: ubuntu-latest
    strategy:
      matrix:
        nodejs_version: [18, 20]
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Setup Node.js ${{ matrix.nodejs_version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.nodejs_version }}

      - name: Cache NPM dependencies
        uses: actions/cache@v3
        with:
          path: node_modules
          key: ${{ runner.os }}-node-modules-${{ hashFiles('package-lock.json') }}

      - name: Install dependencies
        run: npm install

​

Defining the Composite Action

1. Create a directory for custom actions:
   .github/
   └── custom-actions/
       └── npm-action/
           └── action.yml
   
2. Populate action.yml:
   name: 'NPM Cache & Install'
   description: 'Composite action to cache and install NPM packages'
   inputs:
     cache-folder:
       description: 'Directory to cache (e.g., node_modules)'
       required: true
       default: 'node_modules'
   runs:
     using: 'composite'
     steps:
       - name: Cache dependencies
         uses: actions/cache@v3
         with:
           path: ${{ inputs.cache-folder }}
           key: ${{ runner.os }}-node-modules-${{ hashFiles('package-lock.json') }}
   
       - name: Install dependencies
         run: npm install
         shell: bash
   

• Inputs
  • cache-folder: Makes the cache path configurable.
• Steps
  • Reproduce the original cache and install commands.

​

Using Your Composite Action

jobs:
  unit-testing:
    name: Unit Testing
    runs-on: ubuntu-latest
    strategy:
      matrix:
        nodejs_version: [18, 20]
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js ${{ matrix.nodejs_version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.nodejs_version }}

      - name: Cache & install dependencies
        uses: ./.github/custom-actions/npm-action
        with:
          cache-folder: 'node_modules'

​

Links and References

• GitHub Actions: Creating a composite run steps action
• actions/cache
• actions/setup-node
• GitHub Actions Documentation