Commit Graph

29 Commits

Author SHA1 Message Date
Kingdon Barrett 9659efe017
Fix bad link
Signed-off-by: Kingdon Barrett <kingdon@weave.works>
2024-03-12 12:07:07 +01:00
Sanskar Jaiswal 4505fa56da
add support for specifying push options
Add `.spec.git.push.options` to allow specifying the push options to be
sent to the upstream Git server during a push operation. For more info,
see: https://git-scm.com/docs/git-push#Documentation/git-push.txt---push-optionltoptiongt

This is useful for platforms like GitLab when used with
image-automation-controller by enabling the creation of MRs automatically
upon a push operation (ref: https://docs.gitlab.com/ee/user/project/push_options.html#push-options-for-merge-requests)

Signed-off-by: Sanskar Jaiswal <jaiswalsanskar078@gmail.com>
2024-03-12 12:07:06 +01:00
Sanskar Jaiswal 0621bfe75a
git: add docs for usage with Gerrit
Signed-off-by: Sanskar Jaiswal <jaiswalsanskar078@gmail.com>
2024-03-12 12:07:06 +01:00
Sanskar Jaiswal 02d4be7b29
git: add docs for `push.refspec`
Signed-off-by: Sanskar Jaiswal <jaiswalsanskar078@gmail.com>
2024-03-12 12:07:05 +01:00
Kingdon Barrett af5ff68565
Fix links in API docs
Signed-off-by: Kingdon Barrett <kingdon@weave.works>
2024-03-12 12:07:05 +01:00
Max Jonas Werner 6436a8a47f
Align docs structure with other controllers
In some controller we already support multiple API versions at the
same time. In order to streamline the docs structure, the necessary
changes to do the same in this repo are applied here as well.

refs fluxcd/website#1577

Signed-off-by: Max Jonas Werner <mail@makk.es>
2024-03-12 12:07:03 +01:00
Hidde Beydals f725068d20
Rename controllers to controller
Signed-off-by: Hidde Beydals <hidde@hhh.computer>
2024-03-12 12:06:55 +01:00
Sanskar Jaiswal e57e0b55a0
add support for commit sigining PGP key passphrases
Add support for decrypting the private key of the commit signing PGP
key. The secret specified in `spec.commit.signingKey.secretRef` can now
optionally have a `passphrase` key where it's value is the password to
be used for decryptin the private key.

Signed-off-by: Sanskar Jaiswal <jaiswalsanskar078@gmail.com>
2024-03-12 12:06:53 +01:00
Paulo Gomes 97c03c3e90
libgit2: Update documentation
Signed-off-by: Paulo Gomes <paulo.gomes@weave.works>
2024-03-12 12:06:46 +01:00
Paulo Gomes 5b60da632c
Document GitShallowClone and GitForcePushBranch#
Signed-off-by: Paulo Gomes <paulo.gomes@weave.works>
2024-03-12 12:06:46 +01:00
Daniel Holbach 3355b1a8dc
update to new doc links structure
Signed-off-by: Daniel Holbach <daniel@weave.works>
2024-03-12 12:06:38 +01:00
Daniel Holbach fb1ab24e91
update toolkit.f.i docs links
Signed-off-by: Daniel Holbach <daniel@weave.works>
2024-03-12 12:06:25 +01:00
Somtochi Onyekwere 2c3f44cc49
Add flag to disable cross-namespace referencing
Signed-off-by: Somtochi Onyekwere <somtochionyekwere@gmail.com>
2024-03-12 12:06:18 +01:00
Soule BA 3a5507a639
Add support for the sprig functions library
All functions are not supported, The following are discarded:
            // Date functions
            "date",
            "date_in_zone",
            "date_modify",
            "now",
            "htmlDate",
            "htmlDateInZone",
            "dateInZone",
            "dateModify",

            // Strings
            "randAlphaNum",
            "randAlpha",
            "randAscii",
            "randNumeric",
            "uuidv4",

            // OS
            "env",
            "expandenv",

            // Network
            "getHostByName",

Signed-off-by: Soule BA <bah.soule@gmail.com>
2024-03-12 12:06:10 +01:00
Aaron Trout c99bc07ac7
Fix Typo: policiy -> policy
Signed-off-by: Aaron Trout <atrout@confluent.io>
2021-07-14 12:54:13 +01:00
Michael Bridgen f64d6cd4c8 Port API guide from v1alpha2 to v1beta1
The guides are kept in versioned directories, but only one version
appears to make it to the documentation website. For that reason,
rather than trying to refer to the previous version's migration guide,
I've just copied it and adapted it minimally to the new version.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-06-28 11:26:59 +01:00
Michael Bridgen 7378ad7ae7 Change note regarding git implementation field
The implementation is now ignored, in favour of just using libgit2.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-06-02 15:00:36 +01:00
Hidde Beydals 4a71491565 spec: formatting `v1alpha1` -> `v1alpha2` table
The previous format seems to have been a mixture of the format accepted
by most Markdown parsers, and the format Org Mode for Emacs likes.

Anyhow, we breathe Markdown.

Signed-off-by: Hidde Beydals <hello@hidde.co>
2021-04-22 12:15:37 +02:00
Michael Bridgen f746a110c2 Add guide to migrating to v1alpha2
This commit adds a step-by-step guide to rewriting specs for v1alpha2.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-04-13 11:01:45 +01:00
Michael Bridgen b0fc4155fe Write a specification explainer for v1alpha2
This mostly adapts the material in the v1alpha1 spec explainer doc to
the different structure of the v1alpha2 types.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-04-13 11:01:45 +01:00
Stefan Prodan 1332f65372
Release v0.8.0
Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-04-06 17:27:40 +03:00
Jason Raimondi 22fd7a0c77
Fix typo in template code example
Signed-off-by: Jason Raimondi <jason@raimondi.us>
2021-03-18 14:28:56 -07:00
Stefan Prodan 2e53745a03
Allow specifying the path for manifests updates
- Add optional `path` field to `spec.update`, defaults to the git repo root
- Restrict updates to the specified `spec.update.path`

Signed-off-by: Stefan Prodan <stefan.prodan@gmail.com>
2021-03-16 11:58:21 +02:00
Michael Bridgen 340d1a4462 Give an example of {checkout,push}.branch
As a YAML example, this also shows the YAML/JSON field names. Since
field names are different in the Go types, it can be confusing.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-03-15 15:24:09 +00:00
Michael Bridgen 076758aec7 Explain how the push field works
Signed-off-by: Michael Bridgen <michael@weave.works>
2021-03-15 15:08:06 +00:00
Michael Bridgen cfa5a9c574 Phrase the message template example as YAML not go
The message template is used in YAML files, not in go code. I've also
explained up-front that it's a text template -- something not
mentioned to this point.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-03-04 13:28:37 +00:00
Michael Bridgen df7d570ae5 Give details of template data in spec docs
This explains the data available to the commit message template in the
API guide. While writing it, I realised it could be made more
convenient, so:

 - mask external types by embedding them
 - make the most useful parts of an image ref available using a
   wrapper struct and interface

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-03-03 11:08:53 +00:00
Michael Bridgen 78dec3ce89 Update API refs
This commit updates the generated and written API refs to account for
the new update strategy types.

Signed-off-by: Michael Bridgen <michael@weave.works>
2021-01-20 13:59:15 +00:00
Michael Bridgen c33541dd08 Add API reference for ImageUpdateAutomation
Signed-off-by: Michael Bridgen <michael@weave.works>
2021-01-18 14:40:08 +00:00