Flightcontrol External Actions

This directory contains example action files for common development tools that can be used with Flightcontrol's runner system.

Available Actions

1. Node.js (node)

Installs Node.js with npm support.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "node",
      "with": {
        "node-version": "18"
      }
    },
    {
      "type": "command",
      "command": "node --version && npm install"
    }
  ]
}

Supported versions: 16, 18, 20, 21, 22 (uses package manager)

2. Python (python)

Installs Python with pip support.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "python",
      "with": {
        "python-version": "3.10"
      }
    },
    {
      "type": "command",
      "command": "python3 --version && pip install -r requirements.txt"
    }
  ]
}

Supported versions: 3.8, 3.9, 3.10, 3.11, 3.12 (uses package manager)

3. Terraform (terraform)

Installs Terraform via binary download.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "terraform",
      "with": {
        "terraform-version": "1.5.0"
      }
    },
    {
      "type": "command",
      "command": "terraform --version"
    }
  ]
}

4. OpenTofu (tofu)

Installs OpenTofu via binary download.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "tofu",
      "with": {
        "tofu-version": "1.6.0"
      }
    },
    {
      "type": "command",
      "command": "tofu --version"
    }
  ]
}

5. Google Cloud SDK (gcp)

Installs Google Cloud SDK with gcloud, gsutil, and bq.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "gcp",
      "with": {
        "gcloud-version": "latest"
      }
    },
    {
      "type": "command",
      "command": "gcloud --version && gsutil --version"
    }
  ]
}

6. Ruby (ruby)

Installs Ruby with gem support.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "ruby",
      "with": {
        "ruby-version": "3.1"
      }
    },
    {
      "type": "command",
      "command": "ruby --version && gem install bundler"
    }
  ]
}

Supported versions: 3.0, 3.1, 3.2, 3.3 (uses package manager)

7. Go (go)

Installs Go via binary download.

Usage:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "go",
      "with": {
        "go-version": "1.20"
      }
    },
    {
      "type": "command",
      "command": "go version"
    }
  ]
}

Using Multiple Actions

You can combine multiple actions in a single workflow:

{
  "instructions": [
    {
      "type": "uses",
      "uses": "node",
      "with": {
        "node-version": "18"
      }
    },
    {
      "type": "uses",
      "uses": "python",
      "with": {
        "python-version": "3.11"
      }
    },
    {
      "type": "command",
      "command": "node --version && python3 --version"
    }
  ]
}

File Structure

Each action is defined in a separate directory with an action.yaml file:

examples/actions/
├── node/action.yaml
├── python/action.yaml
├── terraform/action.yaml
├── tofu/action.yaml
├── gcp/action.yaml
├── ruby/action.yaml
├── go/action.yaml
└── README.md

Deployment

To use these actions in production, copy the action files to the flightcontrolhq/actions repository under their respective directories.

Architecture Support

Binary downloads automatically handle both AMD64 and ARM64 architectures based on the runner's system architecture.