mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2024-11-13 20:51:41 +00:00
92 lines
4.5 KiB
Markdown
92 lines
4.5 KiB
Markdown
# Woodpecker
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/woodpecker-ci/woodpecker/">
|
|
<img alt="Woodpecker" src="docs/static/img/logo.svg" width="220"/>
|
|
</a>
|
|
</p>
|
|
<br/>
|
|
<p align="center">
|
|
<a href="https://ci.woodpecker-ci.org/repos/3780" title="Pipeline Status">
|
|
<img src="https://ci.woodpecker-ci.org/api/badges/3780/status.svg" alt="Pipeline Status">
|
|
</a>
|
|
<a href="https://codecov.io/gh/woodpecker-ci/woodpecker">
|
|
<img src="https://codecov.io/gh/woodpecker-ci/woodpecker/branch/main/graph/badge.svg" alt="Code coverage">
|
|
</a>
|
|
<a href="https://translate.woodpecker-ci.org/engage/woodpecker-ci/">
|
|
<img src="https://translate.woodpecker-ci.org/widgets/woodpecker-ci/-/ui/svg-badge.svg" alt="Translation status" />
|
|
</a>
|
|
<a href="https://matrix.to/#/#woodpecker:matrix.org" title="Join the Matrix space at https://matrix.to/#/#woodpecker:matrix.org">
|
|
<img src="https://img.shields.io/matrix/woodpecker:matrix.org?label=matrix" alt="Matrix space">
|
|
</a>
|
|
<a href="https://goreportcard.com/report/go.woodpecker-ci.org/woodpecker/v2" title="Go Report Card">
|
|
<img src="https://goreportcard.com/badge/go.woodpecker-ci.org/woodpecker/v2" alt="Go Report Card">
|
|
</a>
|
|
<a href="https://pkg.go.dev/go.woodpecker-ci.org/woodpecker/v2" title="go reference">
|
|
<img src="https://pkg.go.dev/badge/go.woodpecker-ci.org/woodpecker/v2" alt="go reference">
|
|
</a>
|
|
<a href="https://github.com/woodpecker-ci/woodpecker/releases/latest" title="GitHub release">
|
|
<img src="https://img.shields.io/github/v/release/woodpecker-ci/woodpecker?sort=semver" alt="GitHub release">
|
|
</a>
|
|
<a href="https://hub.docker.com/r/woodpeckerci/woodpecker-server" title="Docker pulls">
|
|
<img src="https://img.shields.io/docker/pulls/woodpeckerci/woodpecker-server" alt="Docker pulls">
|
|
</a>
|
|
<a href="https://opensource.org/licenses/Apache-2.0" title="License: Apache-2.0">
|
|
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache-2.0">
|
|
</a>
|
|
<a href="https://bestpractices.coreinfrastructure.org/projects/5309">
|
|
<img src="https://bestpractices.coreinfrastructure.org/projects/5309/badge" alt="OpenSSF best practices">
|
|
</a>
|
|
<a href="https://results.pre-commit.ci/repo/github/179344069" title="pre-commit.ci">
|
|
<img src="https://results.pre-commit.ci/badge/github/woodpecker-ci/woodpecker/main.svg" alt="pre-commit.ci">
|
|
</a>
|
|
</p>
|
|
<br/>
|
|
|
|
Woodpecker is a simple, yet powerful CI/CD engine with great extensibility.
|
|
|
|
![woodpecker](docs/docs/woodpecker.png)
|
|
|
|
## Installation & Resources
|
|
|
|
Woodpecker can be installed in various ways (see the [Installation Instructions](https://woodpecker-ci.org/docs/administration/getting-started)) and by, default, runs with a SQLite DB.
|
|
It requires around 100 MB of RAM (Server) and 30 MB (Agent) at runtime in idle mode.
|
|
|
|
## Support
|
|
|
|
You can support the project by becoming a backer on [Open Collective](https://opencollective.com/woodpecker-ci#category-CONTRIBUTE) or via [GitHub Sponsors](https://github.com/sponsors/woodpecker-ci).
|
|
|
|
<a href="https://opencollective.com/woodpecker-ci" target="_blank"><img src="https://opencollective.com/woodpecker-ci/backers.svg?width=890" alt="Open Collective backers"></a>
|
|
|
|
## Documentation
|
|
|
|
<https://woodpecker-ci.org/docs/>
|
|
|
|
## Translation
|
|
|
|
We have a self-hosted [Weblate](https://weblate.org/en/) instance at [translate.woodpecker-ci.org](https://translate.woodpecker-ci.org).
|
|
|
|
An overview of the current translation state is available at <https://translate.woodpecker-ci.org/projects/woodpecker-ci/#languages>.
|
|
|
|
To help with translation, the language-specific files in <https://github.com/woodpecker-ci/woodpecker/tree/main/web/src/assets/locales> can be edited.
|
|
|
|
## Public Woodpecker Instances
|
|
|
|
Woodpecker is used as the main CI/CD engine at [Codeberg](https://codeberg.org), an alternative Git hosting platform with a focus on privacy and free software development.
|
|
|
|
## Plugins
|
|
|
|
Woodpecker can be extended via plugins.
|
|
The [plugin overview website](https://woodpecker-ci.org/plugins) helps browsing available plugins.
|
|
It combines both plugins by the Woodpecker core team and community-maintained ones.
|
|
|
|
## Star History
|
|
|
|
[![Star History Chart](https://api.star-history.com/svg?repos=woodpecker-ci/woodpecker&type=Date)](https://star-history.com/#woodpecker-ci/woodpecker&Date)
|
|
|
|
## License
|
|
|
|
Woodpecker is Apache 2.0 licensed.
|
|
The source files have a header indicating which license they are under and what copyrights apply.
|
|
|
|
Everything in `docs/` is licensed under the Creative Commons Attribution-ShareAlike 4.0 International Public License.
|