# Task Runner for the CI / CD Pipeline

* **Status:** Active
* **Last Modified:** 2023-06-29
* **Related Issue:** [ADR: Task Runner and CI / CD interface #92](https://github.com/HHS/simpler-grants-gov/issues/92)
* **Deciders:** Lucas, Aaron, Billy
* **Tags:** Continuous Integration, Continuous Deployment

## Context and Problem Statement

A task runner needs to be selected and an interface described to initiate tasks so that the project can perform necessary testing, linting, other continuous integration tasks, and continous deployment.

The task runner should be able to run on commits and pull requests and support both testing of code and deployment to various environments. The task runner should be able to run tasks within its own environment as well as initiate remote tasks.

## Decision Drivers

* **speed:** The task runner should produce fast results compared to other options. Some of the components that produce a speedy result include time to initiate the task, time to prepare environments, speed of running similar types of steps (I.E. spin up docker containers), caching capabilities, and ability to parallelize tasks. The project will not have time to test the speed with different tools.
* **ease of use:** The task runner and interface should be easy to use for developers. Tasks run in the CI tool should be able to be run on local environments where possible. The tool and interface should be well documented. The task runner should have tools, communities, or patterns that make creating new tests or deployments easier.
* **cost:** The task runner should be cost-competitive.
* **security and authorization:** The project should have relevant security credentials like Fedramp authorization and should be authorized specifically for the project.

## Options Considered

* [Github Actions](https://github.com/features/actions)
* [Travis CI](https://www.travis-ci.com/)
* [Circle CI](https://circleci.com/)

## Decision Outcome

Github Actions offers competitive speed, developer support, shared / resusable actions, is part of Github which is already approved on the project and part of the [Fedramp marketplace](https://marketplace.fedramp.gov/products/FR1812058188), and is free.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.simpler.grants.gov/product/decisions/adr/2023-06-29-ci-cd-task-runner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.