Skip to content

actions4git/setup-git

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Setup Git environment

🔶 Configure Git for GitHub Actions

- run: git commit --message 'Automated changes'
# ❌ Please tell me who you are.
# Run
#   git config --global user.email "you@example.com"
#   git config --global user.name "Your Name"
- uses: actions4git/setup-git@v1
- run: git commit --message 'Automated changes'
# ✅ Committed 3 files

📂 Lets you add additional safe directories
🔑 Configures Git to use github.token when pushing/pulling from github.server_url
👤 Sets up @github-actions[bot] as the default Git author

Usage

Git GitHub Actions

🚀 Here's what you want:

on: push
jobs:
  job:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions4git/setup-git@v1
      - run: npx --yes prettier --write .
      - run: git add --all
      - run: git commit --message 'Prettier' #
      - run: git push

Inputs

⚠️ Support for choosing a git-version is not yet implemented. Contributions are welcome! ❤️

  • github-token: GitHub token to use for authentication when pulling and pushing to the GitHub instance defined by github-server-url. By default this is unset. You can set this to github.token or a personal access token if you want to configure GitHub authentication globally.

  • github-server-url: Server URL like https://github.example.org to use as the scope for the github-token. By default this uses github.server_url which is usually https://github.com. You shouldn't need to change this.

  • user: A Name Here <emailhere@example.org> AiO user name & email string. This is a shortcut alternative to the independant user-name and user-email options that are also available. This defaults to @github-actions[bot]. You can set this to the special value github-actions to use the @github-actions[bot] user as the author, or the special me value to use the current github.actor user as the author.

  • user-name: The name of the user. Should be left unspecified if user is specified.

  • user-email: The email of the user. Should be left unspecified if user is specified.

  • safe-directory: A multiline list of globs to add to the Git safe-directory list. Defaults to the current directory ..

Outputs

TODO!

Development

Node.js

How do I test my changes?

Open a Draft Pull Request and some magic GitHub Actions will run to test the action.