Commit graph

211 commits

Author SHA1 Message Date
John Olheiser
517be0394c
Initial version of CLI docs (#886)
Signed-off-by: jolheiser <john.olheiser@gmail.com>

Co-authored-by: Anbraten <anton@ju60.de>
2022-04-19 14:24:24 +02:00
Ruan Bekker
3a3282cde2
Add blogpost about setup of Woodpecker and Gitea (#883) 2022-04-14 09:16:16 +02:00
jklippel
a5a288718d
FIX: database docker-compose documentation (#878)
environment in docker-compose files is an array: lines start with a dash (-) and key value assignments are done using an equal sign (=)

Co-authored-by: 6543 <6543@obermui.de>
2022-04-13 23:04:50 +02:00
mscherer
410b0bb217
Add some warning regarding the local backend (#875) 2022-04-07 17:50:37 +02:00
Anbraten
ee97977b93
Update and cleanup docs (#851)
- migrate step conditions back into pipeline syntax, but show 2-4 level in toc to be able to see `when` keywords
- create new backend section in admin docs
- update docusaurus
- remove prefix docker of container / container-image where possible
- replace terms SCM, VCS, Github with [forge](https://en.wikipedia.org/wiki/Forge_(software))
- add darkmode favicon variant
2022-04-06 17:15:28 +02:00
qwerty287
eb6d69e1fd
Use Gogs' try instance as default value (#852) 2022-03-27 04:05:56 +02:00
Andreas Brain
4cfe01b078
Fix broken link (#844) 2022-03-20 23:44:54 +01:00
Anthony Wang
80c72b590c
Add support to run pipelines using a local backend (#709)
This adds support for #559. I tested using [this .woodpecker.yml](https://git.exozy.me/Ta180m/Hello-world/src/branch/main/.woodpecker.yml) on my self-hosted [Woodpecker instance](https://ci.exozy.me/Ta180m/Hello-world). I was also able to get this to build [Hugo websites](https://ci.exozy.me/Ta180m/howtuwu/build/1). It's currently very simplistic but works!

close #559
2022-03-10 22:07:02 +01:00
Johan Van de Wauw
8fa2a5efe4
Fix various typos (#835) 2022-03-09 01:44:08 +01:00
mscherer
32d56ed795
Fix links in documentation (#832) 2022-03-04 09:16:21 +01:00
Lukas Bachschwell
c16d42f81e
Add missing flag and docs (#825)
* Add missing flag and docs

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
Co-authored-by: Anbraten <anton@ju60.de>
2022-03-02 16:49:00 +01:00
Lukas Bachschwell
09e6460f95
Allow loading sensitive flags from files (#815)
With systems like docker swarm or docker compose it is usually a little awkward to manage secrets. 
There is no way to directly inject them into the environment config. So you often have to write your secrets directly into the compose file

There are hacky workarounds such as overriding the entry-point of the container and loading a script which then fetches secrets from /run/secrets and replaces the environment variables, but this becomes very difficult once we are using docker images built from "scratch" (which is a really great practice otherwise) as there is no shell or standard tooling available

This adds a *_FILE variant of their Environment config values to work around this issue.

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>
2022-03-01 16:09:33 +01:00
Lukas Bachschwell
59ba8538a1
Add support for pipeline configuration service (#804)
* Add configuration extension flags to server
Add httpsignatures dependency

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Add http fetching to config fetcher

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Refetch config on rebuild

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* - Ensure multipipeline compatiblity
- Send original config in http request

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Basic tests of config api

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Simple docs page

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Better flag naming

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Rename usages of the term yaml
Rename ConfigAPI struct

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Doc adjustments

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* More docs touchups

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Fix env vars in docs

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* fix json tags for api calls

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Add example config service

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Consistent naming for configService

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Docs: Change example repository location

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Fix tests after response field rename

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Revert accidential unrelated change in api hook

Signed-off-by: Lukas Bachschwell <lukas@lbsfilm.at>

* Update server flag descriptions

Co-authored-by: Anbraten <anton@ju60.de>

Co-authored-by: Anbraten <anton@ju60.de>
2022-02-28 10:56:23 +01:00
Anbraten
40b5c6a320
Add hint for not visibles trusted option in project settings for non-admins (#807) 2022-02-26 15:01:51 +01:00
René Schaar
dde0678246
Update docker hub link (#779)
The old docker hub link directs you either to a login page or to your profile. I think it makes more sense to redirect the user directly to available images in the explore tab
2022-02-20 21:47:49 +01:00
Zav Shotan
905350fa15
Add support for default clone image environment variable (#769)
This allows for custom clone images for deployment in air-gap systems.

Co-authored-by: Zav Shotan <zshotan@bloomberg.net>
2022-02-10 17:05:19 +01:00
Anbraten
3b4dc03486
Move vcs configs and hide some unstable options from docs (#755)
move vcs configs to their pages, hide some unclear options
2022-02-09 20:32:38 +01:00
Zav Shotan
f16525fae5
Add flag to always authenticate when cloning public repositories (#760)
As a developer using an custom git server (e.g. Github Enterprise) I would like to be able to authenticate 
the user on repositories which are marked as public.

See issue: https://github.com/woodpecker-ci/woodpecker/issues/473

Ref: https://github.com/woodpecker-ci/woodpecker/pull/693#issuecomment-1025771162
2022-02-08 17:55:08 +01:00
KN4CK3R
5f79739bc0
Add documentation of all server configuration options (#666)
* Added documentation of all configuration options.

* sort some flags

* adjust config docs to current flags

Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: Anton Bracke <anton@ju60.de>
2022-02-06 21:21:57 +01:00
Anbraten
9ff0f230ec
Add awesome page (#744) 2022-02-04 10:53:03 +01:00
6543
7b2b884a0e
Add Codecov.io Upload (#660)
use https://github.com/woodpecker-ci/plugin-codecov to track code coverage on codecov.io
2022-02-01 19:34:56 +01:00
Anbraten
6af94d79e3
Remove unused flags / options (#693)
Some flags where unused and / or unnecessary as they are covered by alternatives implemented in PRs of milestone 0.15.0 and just complicated the setup.

closes #681
2022-01-31 15:38:00 +01:00
6543
6d29651808
Update 10-overview.md (#728)
* Update 10-overview.md

* Update docs/docs/30-administration/20-vcs/10-overview.md

Co-authored-by: Anbraten <anton@ju60.de>
2022-01-30 08:42:11 +01:00
6543
edbf6a3ba9
Allow to change status context again (#674)
* use flag value

* fix test

* sed -i 's/STATUS_CONTEXT/WOODPECKER_STATUS_CONTEXT/g'

* docs

* Update docs/docs/91-migrations.md

Co-authored-by: Anbraten <anton@ju60.de>
2022-01-29 20:37:36 +01:00
jdoubleu
48089f53d8
Add note about Gitlab & Gitea internal connections to docs (#711)
* add note about Gitlab internal connections to docs

* add note about Gitea internal connections to docs
2022-01-27 19:15:15 +01:00
Thomas McWork
262d29700e
fix typo in docs (#716) 2022-01-24 16:11:00 +01:00
FestplattenSchnitzel
9feb6be9f2
Fix typo (#714) 2022-01-23 02:25:44 +01:00
jdoubleu
074e2cd38a
minor updates to docs (#712)
* correct minor spellings in the docs

* add warning about artifacts not being shared in multi-pipelines

* highlight note on multi-pipelines docs page

* update mentions of GitLab to use its official notation (camel case)
2022-01-20 18:24:16 +01:00
Anbraten
401072abb1
Support ChangedFiles for Github & Gitlab PRs and Gitlab pushes (#697) 2022-01-17 23:46:59 +01:00
Anbraten
50570cba5c
Automatically determine platform of agent (#690)
* Automatically determine platform of agent

* add migration hint

* cleanup docs a bit
2022-01-17 15:19:30 +01:00
6543
04eb7935db
Improve compile pipeline (#699)
Refactor
- use constants for strings
- more tests
- move constraint code into own package

Enhance
- all constrains use doublestart (glob pattern matching) now

Co-authored-by: Anbraten <anton@ju60.de>
2022-01-17 14:43:30 +01:00
Anbraten
b15879d460
Update 80-downloads.md (#691) 2022-01-16 00:26:55 +01:00
Kaleb Elwert
62557ffeff
Only publish to latest on tags (#505)
* Only publish to latest on tags

* Update docs

Co-authored-by: 6543 <6543@obermui.de>
2022-01-15 17:49:31 +01:00
Anbraten
ce222dfe0e
Add registries docs (#679) 2022-01-09 02:50:25 +01:00
KN4CK3R
77923ad3dd
Add documentation of all agent configuration options (#667)
Co-authored-by: Anbraten <anton@ju60.de>
Co-authored-by: 6543 <6543@obermui.de>
2022-01-08 23:22:06 +01:00
6543
c186e2fa8c
Update dev-docs & improve migration code (#670) 2022-01-08 20:21:22 +01:00
6543
d11b2bb8e5
Mention Matrix Space & Rooms in Readme & Docs (#646)
* Mention Matrix Space & Rooms in Readme & Docs

* custom labels

Co-authored-by: John Olheiser <john.olheiser@gmail.com>

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
2021-12-30 11:53:52 -06:00
Philipp
4f015edc05
Add repo to when block (#642)
Co-authored-by: 6543 <6543@obermui.de>
2021-12-30 02:30:08 +01:00
Anbraten
bed69f9f72
Improve dev docs (#636) 2021-12-21 10:52:10 +01:00
Anbraten
465d2c9d84
Add development docs (#610)
Add documentation on how to develop woodpecker

Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: Lukas <lukas@slucky.de>
2021-12-21 04:45:41 +01:00
6543
ce5247c675
pipeline env migrate CI_TAG & CI_PULL_REQUEST to new CI_COMMIT_TAG & CI_COMMIT_PULL_REQUEST (#624)
* CI_TAG => CI_COMMIT_TAG

* CI_PULL_REQUEST => CI_COMMIT_PULL_REQUEST

* add TODO for drop with v0.16.0 development
2021-12-19 17:01:03 +01:00
Anbraten
934847e855
update docs (#611) 2021-12-18 01:05:23 +01:00
John Olheiser
9e8d1a9294
Get secrets in settings (#604)
* Get secrets in settings

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Add error test

Signed-off-by: jolheiser <john.olheiser@gmail.com>

* Add docs

Signed-off-by: jolheiser <john.olheiser@gmail.com>
2021-12-13 13:33:07 -06:00
fnetX (aka fralix)
442561fea2
Clarify Docs on Docker for new users in intro (#606)
In the Codeberg CI Matrix channel, there was confusion about the `image` specifying Docker containers. I changed some phrases and hopefully made it clearer to new users.
2021-12-13 18:07:36 +01:00
Anbraten
ca465cec1a
Update proxy documentation (#573) 2021-12-08 13:03:17 +01:00
6543
7fb9191cce
Update Documentation (fix diffs and add settings) (#569)
* Add migration guide for plugin settings

* Update screenshot snippets

* Adjust plugin settings

* Fix diff insertion

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
2021-12-06 18:18:53 +01:00
John Olheiser
71b9179078
Move plugin config to root.pipeline.[step].settings (#464)
* Move Vargs to Settings

* Allow both until deprecation

* Add more tests

* Adjust schema

* Add missing detach option, fix schema tests


Signed-off-by: jolheiser <john.olheiser@gmail.com>
Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: Anbraten <anton@ju60.de>
2021-12-04 16:44:18 +01:00
6543
d3eabbdebc
Update README (#560)
* Add "Stars over time to README
* Move info from README into docs & link to it
* New CI location
* New screenshot

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
2021-12-03 15:36:22 +01:00
seabass-labrax
494c211910
Add notice of supported YAML versions in docs (#556)
Co-authored-by: Anbraten <anton@ju60.de>
2021-12-01 12:00:41 +01:00
Anbraten
c4700e9693
Update docs dependencies (#553) 2021-11-27 15:13:00 +01:00
Anbraten
063d0bb32a
Replace DRONE_ with CI_ variables in pipeline steps (#427)
Dropped support for `DRONE_*` environment variables in pipeline steps. Pipeline meta-data can be accessed with `CI_*` variables.
  - `CI_*` prefix replaces `DRONE_*`
  - `CI` value is now `woodpecker`
  - `DRONE=true` has been removed
2021-11-25 20:43:31 +01:00
Isuru Fernando
d02dfe993f
Update docs about selecting agent based on platform (#470)
Update docs about selecting agent based on platform for global pipeline config
2021-11-21 02:18:34 +01:00
Tim Coombs
745090b3af
Update Agent and Pipeline syntax documentation (#506)
- Creates `Agent Config` with examples of agents and configuration options
- Updates `Pipeline Syntax`
  - About the different types of conditionals
  - Sort Order (Global -> Step -> Advanced)
- Move Conditional Steps to own page

Co-authored-by: 6543 <6543@obermui.de>
2021-11-20 20:45:59 +01:00
Anbraten
06800cb61e
Change paths to use woodpecker instead of drone (#494)
* change paths to use woodpecker instead of drone

* improve sql file migration

* add migration notice
2021-10-28 14:02:43 -05:00
Anbraten
b10f10a290
pin ua-parser-js versions to ^0.7.30 (#467) 2021-10-24 12:58:56 +02:00
Anbraten
7725058f03
Release deb, rpm bundles (#405) 2021-10-20 21:55:09 +02:00
Anbraten
0812a29163
Add plugin marketplace (for official plugins) (#451)
Co-authored-by: 6543 <6543@obermui.de>
2021-10-19 18:54:01 +02:00
Anbraten
ed03a318c5
Improve docs (#450)
- update docusaurus
- add typescript
- add prettier
- add open-collective & sponsor us links
- add announcement bar (star on github)
- add mastodon (footer)
- collapse admin area in sidebar by default
- move faq doc to pages
2021-10-16 21:27:51 +02:00
Anbraten
4f8a9893cf
Add search to docs (#448) 2021-10-16 21:05:13 +02:00
6543
6828057f66
Switch default git plugin (#449)
* update pipeline samples

* update docs

* use woodpeckerci/plugin-git:latest as default

* code format nit
2021-10-15 19:54:28 -05:00
Anbraten
4cc8594b63
Update links to woodpecker-ci.org (#445) 2021-10-14 18:13:57 +02:00
John Olheiser
12db87f8e6
Change prometheus namespace to woodpecker (#439)
Signed-off-by: jolheiser <john.olheiser@gmail.com>
2021-10-13 08:34:57 +02:00
luzpaz
9b687a923e
Fix various typos (#416)
Fix various typos found via `codespell -q 3 -S vendor -L pullrequest,pullrequests`
2021-10-08 18:35:56 +02:00
Anbraten
d15c642f91
Release cli images (#404)
* release cli images

* update docs

Co-authored-by: 6543 <6543@obermui.de>
2021-10-04 23:47:21 +02:00
Anbraten
f98d17c3e4
Add image migration docs (#406)
document move from `latest` to `next` as edge image
2021-10-04 23:32:56 +02:00
6543
e3354e440f
Publish alpine container (#398)
* Enable build & publish of alpine docker container
 * Delete outdated BUILD file
 * Move Dockerfiles into subdir "docker"
 * Update & format Dockerfiles
 * Introduce "next" tag

Co-authored-by: Anbraten <anton@ju60.de>
2021-10-04 17:09:22 +02:00
6543
169e7e5aa3
Refactor Gitlab Remote (#358)
- Replace custom client
- Update Docs
- Test if it works
- Update Tests

close #285
2021-10-03 14:42:47 +02:00
6543
44ae414bce
Add Migrations to docs header (#386)
* Docs: add Migrations to header

* fix diff
2021-09-30 15:39:20 +02:00
Marian Steinbach
17b8867b96
Clean up config environment variables for server and agent (#218)
The goal here is to make consistent use of configuration environment variables prefixed `WOODPECKER_`. Where several variants existed, this PR aims to remove all but one option, leaving the most explicit.

This PR only changes server and agent code, but not documentation, in order to keep the PR digestible. Once we have consensus that this is correct, I'll change docs accordingly.

User (rather: admin) facing changes in this PR:

- In general, support for all server and agent config environment variables (env vars) starting with `DRONE_` is removed. The according `WOODPECKER_*` variables must be used instead.
- The env var `WOODPECKER_HOST` replaces `DRONE_HOST`, and `DRONE_SERVER_HOST`.
- The env var `WOODPECKER_AGENT_SECRET` is used to configure the shared secret which agents use to authenticate against the server. It replaces `WOODPECKER_SECRET`, `DRONE_SECRET`, `WOODPECKER_PASSWORD`, `DRONE_PASSWORD`, and `DRONE_AGENT_SECRET`.
- The env var `WOODPECKER_DATABASE_DRIVER` replaces `DRONE_DATABASE_DRIVER` and `DATABASE_DRIVER`.
- The env var `WOODPECKER_DATABASE_DATASOURCE` replaces `DRONE_DATABASE_DATASOURCE` and `DATABASE_CONFIG`.
2021-09-28 15:43:44 +02:00
6543
c0888de86b
Delete Gerrit placeholder (#372) 2021-09-28 10:22:34 +02:00
Anbraten
3f03052190
[Docs] Simplify docker-compose samples (#356) 2021-09-28 00:04:52 +02:00
Anbraten
ecc5f24fec
Explain open registration setting (#361) 2021-09-26 16:33:55 +02:00
Anbraten
72e42f1612
Optimize license files (#355)
Updated license files to be automatically be parseable by tools like [licensechecker](https://github.com/google/licensecheck) or Github. This is for example needed for godoc.
2021-09-25 15:15:54 +02:00
Anbraten
e8db6b8c04
Update 80-kubernetes.md (#350) 2021-09-24 15:45:35 +02:00
Anbraten
0009c19f1c
Release Helm charts (#302)
closes #261
2021-09-24 14:04:54 +02:00
Anbraten
96828b16c1
Support recursive glob for path conditions (#327)
* Support glob with doublestar for path conditions

* Update docs and pipeline
2021-09-21 06:18:43 +02:00
Nulo
8413bb0620
Remove non-existent changed status condition from docs (#322)
* docs(status): rewrite

status: changed doesn't exist in the current codebase and the
description was just confusing.

* Use consistent language

Co-authored-by: Anbraten <anton@ju60.de>

Co-authored-by: Nulo <git@nulo.in>
Co-authored-by: Anbraten <anton@ju60.de>
2021-09-19 13:02:24 +02:00
Nulo
427d26ebed
Fix typo in docs: plattform -> platform (#323)
Co-authored-by: Nulo <git@nulo.in>
2021-09-18 17:24:49 +02:00
Nulo
387760ccbf
Improve plugin docs (#313)
* docs: improve plugin docs

* drone do not use ssl

Co-authored-by: Anbraten <anton@ju60.de>

Co-authored-by: Nulo <git@nulo.in>
Co-authored-by: Anbraten <anton@ju60.de>
Co-authored-by: 6543 <6543@obermui.de>
2021-09-17 22:08:13 +02:00
Anbraten
289f0c9ad6
Change pipeline config path resolution (#299)
# Config resolution
- pipeline-config setting empty / not specified (default): `.woodpecker/` => `.woodpecker.yml` => `.drone.yml`
- pipeline-config setting defined by user: try that file / folder and no fallback (if a user sets some special value that is normally done for some reason)

# Changes
- pipeline-config setting will be empty by default
- remove fallback setting for config loading (simplifies config)

---
closes #133

---

* adjust config fetching mechanism

* default path empty

* remove fallback flag from ui and db
2021-09-17 21:40:43 +02:00
Anbraten
2bfeb9e1fa
Improve administration docs (#307)
* Improve administration docs

* Correct docker image names

* Update docs README

Co-authored-by: 6543 <6543@obermui.de>
2021-09-16 18:50:53 +02:00
Anbraten
9267a46d5c
[Docs] Migrate docs framework to Docusaurus (#282)
- Replace mkdocs with docosaurus (improved menu structure, ...)
- Structure docs into `Usage` and `Server Setup / Administration`
- Update favicon
- Create new pipeline-syntax page with all options and links to more detailed docs if available
- Add ci to publish to `woodpecker-ci.github.io`
- Deploy docs preview to surge for review
- Update start-page

Co-authored-by: 6543 <6543@obermui.de>
2021-09-11 17:10:32 +02:00
6543
ee3e4bb189
Add "path" support to gitea on push hooks (#235) 2021-07-04 20:38:59 +02:00
Alex Eftimie
2ff91e6a05
Add support for path-prefix condition (#174)
Example:
```yaml
when:
  path: '*.md'
```

should match only builds in which the commit added/removed or modified files with the *.md extension

Co-authored-by: 6543 <6543@obermui.de>
2021-06-28 23:50:35 +02:00
6543
310c46d3ab
Switch in docs to new docker hub image repo (#227) 2021-06-18 20:48:22 +02:00
Laszlo Fogas
a6ffa54639
We only support drone.yml for now 2021-05-31 13:43:57 +02:00
Laszlo Fogas
f9edbc5091
We only support .drone.yml for now 2021-05-31 13:42:22 +02:00
Laszlo Fogas
885812fb94
We only support .drone.yml for now 2021-05-31 13:40:28 +02:00
Marian Steinbach
dcb96af9c4
Use WOODPECKER_ env vars in docs (#211) 2021-05-31 13:31:52 +02:00
Laszlo Fogas
c7ebd68232 Relaced laszlocph/woodpecker with woodpecker-ci/woodpecker 2021-05-25 14:08:27 +02:00
Laszlo Fogas
b7085a4c67 Fixing manifest errors 2021-04-26 10:12:37 +02:00
UnlimitedCookies
caf5ec1df7
Found another typo 2021-03-02 02:06:57 +01:00
UnlimitedCookies
d1fbe6a961
Fix typo 2021-03-02 02:01:26 +01:00
Brady Owens
f46846e031 Add a notice at the top of the doc about Multi Pipeline and Github only 2020-12-07 18:53:15 -05:00
Jens Heinrich
79ea9eee35
Update server-setup.md
Add a shared socket directory instead of using an unencrypted TCP connection
2020-08-03 16:40:57 +02:00
Laszlo Fogas
f256583419 Global registry 2020-05-20 09:24:55 +02:00
Laszlo Fogas
e0111eded4 Documenting flag 2020-05-20 06:58:21 +02:00
Laszlo Fogas
581f08b54b Full example 2020-05-19 14:33:27 +02:00
Laszlo Fogas
73481dfa0c Document global environment variables 2020-05-19 14:31:27 +02:00
Laszlo Fogas
cf8bca5bc7 K8s DinD deployment 2020-04-28 21:30:52 +02:00