Salt Git Formula

Install and configure git. Clone and update local git repositories.

General notes

See the full SaltStack Formulas installation and usage instructions.

See example.yml on how to configure the formula.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

Available states

`git`

Includes the following states:

git.install
git.repo
git.config

`git.install`

Installs git.

`git.repo`

Can clone, update and delete a local git repository. You can use this state to verify a local git repo is checked out on your system.

`git.config`

Includes the following states:

git.config.system
git.config.user

`git.config.system`

Ensure a system wide git config is set/unset.

`git.config.user`

Ensure a user wide git config is set/unset.

Testing

Linux testing is done with kitchen-salt.

All tests and lint jobs are executed in GitHub Actions.

Requirements

You can test the formula locally after installing the following requirements.

vagrant
VirtualBox
Ruby
bundler

Run Test

bundle install
kitchen list # list all available test instances
kitchen test <instance>

Known Errors

salt state git.config_unset throws an error - see issue 65715

OS support matrix

This formula has been tested under the following operating systems and salt versions.

OS	3006.0	3006.5	3006.6	3006.7	3007.0
Debian 12	❌	✅	✅	✅	✅
Ubuntu 22.04	❌	✅	✅	✅	✅
Rocky 9	❌	✅	✅	✅	✅
Fedora 38	❌	✅	✅	✅	✅
OpenSUSE 15	✅	Not released	Not released	Not released	Not released

The automated release is failing 🚨

🚨 The automated release from the `main` branch failed. 🚨

I recommend you give this issue a high priority, so other packages depending on you can benefit from your bug fixes and new features again.

You can find below the list of errors reported by semantic-release. Each one of them has to be resolved in order to automatically publish your package. I’m sure you can fix this 💪.

Errors are usually caused by a misconfiguration or an authentication problem. With each error reported below you will find explanation and guidance to help you to resolve it.

Once all the errors are resolved, semantic-release will release your package the next time you push a commit to the main branch. You can also manually restart the failed CI job that runs semantic-release.

If you are not sure how to resolve this, here are some links that can help you:

If those don’t help, or if this issue is reporting something you think isn’t right, you can always ask the humans behind semantic-release.

Cannot push to the Git repository.

semantic-release cannot push the version tag to the branch main on the remote Git repository with URL https://x-access-token:[secure]@github.com/genaumann/salt-git-formula.

This can be caused by:

a misconfiguration of the repositoryUrl option
the repository being unavailable
or missing push permission for the user configured via the Git credentials on your CI environment

Good luck with your project ✨

Your semantic-release bot 📦🚀

genaumann / salt-git-formula Goto Github PK

salt-git-formula's Introduction

Salt Git Formula

General notes

Available states

git

git.install

git.repo

git.config

git.config.system

git.config.user

Testing

Requirements

Run Test

Known Errors

OS support matrix

salt-git-formula's People

Contributors

Watchers

salt-git-formula's Issues

🚨 The automated release from the main branch failed. 🚨