Creating a GitHub Action

You can add any task you'd like to your project by writing your own GitHub Action. You can also store secrets in your repository to use in your actions.

Note: GitHub Actions is currently in public beta and subject to change.

In this article

Creating a GitHub Action

GitHub Actions can run any existing Docker container, or you can define a new action by adding a Dockerfile to your repository. For more information, see "Creating GitHub Actions" in the GitHub Developer documentation.

After you create your action, you can add it to a repository's workflow. Actions hosted in private repositories can only be used in the same repository. Actions in public repositories are available for use in any other repository on GitHub.

You can publish your action in GitHub Marketplace. For more information, see "Publishing an action in the GitHub Marketplace" in the GitHub Developer documentation.

Storing secrets in your repository

You can store secrets only accessible to your repository to use in your GitHub Actions. For more information, see "Storing secrets" in the GitHub Developer documentation.

Warning: Do not store production secrets in the API during the limited public beta period. Production workflows should not be used during the limited public beta.

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Settings.

    Repository settings button

  3. In the left sidebar, click Secrets.

    Secrets tab in the repository settings sidebar

  4. Click Add a new secret.

    Add a new secret link

  5. Type a name and value for your secret, then click Add secret.

    Name and Value fields and Add secret button

Further reading

Ask a human

Can't find what you're looking for?

Contact us