Commit Graph

39 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
Sanskar Jaiswal 1bda340df0
git: add push.refspec to push using a refspec
Add `.spec.git.push.refspec` to allow specifying a refspec to be used
for performing a push operation. If specified alongside
`.spec.git.push.branch`, two push operations, one for each specified
push configuration will be performed.

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
Max Jonas Werner d408854b0c
bump API deps; GitRepository v1
Signed-off-by: Max Jonas Werner <mail@makk.es>
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
Sunny 67092fb0e3
Use new standardized runtime and meta package
Signed-off-by: Sunny <darkowlzz@protonmail.com>
2024-03-12 12:06:22 +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
Sanskar Jaiswal df59cee29d
add support for cross-namespace sourceRef in ImageUpdateAutomation
ImageUpdateAutomation objects can now refer to GitRepository objects in other
namespaces. Implemented by switching sourceRef from a SourceReference to a
dependency.CrossNamespaceDependencyReference.

Signed-off-by: Sanskar Jaiswal <sanskar.jaiswal@weave.works>
2024-03-12 12:06:17 +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 5b9631327f Graduate v1alpha2 API to v1beta1
This does the following:

 - copies the type definitions from v1alpha2 to v1beta1
 - changes the "stored" version to v1beta1
 - gives the CRD a conversion strategy of None, meaning just rewrite the version
 - switches the controller to use v1beta1
 - moves the generated documentation to v1beta1

This effectively rebadges the v1alpha2 version of this part of the
image API to v1beta1. The v1alpha2 version is left in place; there are
no conversion issues, as with v1alpha1->v1alpha2. The CRD specifies
that converting between v1alpha2 and v1beta1 just means changing the
version (i.e., the schema and semantics are the same).

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
Michael Bridgen 1c33a2d45f Generate docs for v1alpha2
This switches the API doc generation from v1alpha1, to v1alpha2.

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
LWJ b668e99a91 SigningKey modifications to align process with SOPS
Signed-off-by: LWJ <lwjames1996@gmail.com>
2021-03-24 21:54:31 +00:00
LWJ 4aa56f1013 Add SigningKey to CommitSpec
Signed-off-by: LWJ <lwjames1996@gmail.com>
2021-03-24 21:54:31 +00: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
Michael Bridgen c069305a42 Change optional RunInterval to required Interval
This is to line up better with the other GitOps Toolkit API types.

Signed-off-by: Michael Bridgen <michael@weave.works>
2020-12-07 14:58:13 +00:00
Michael Bridgen 0cf879abd2 Add generated API docs
Signed-off-by: Michael Bridgen <michael@weave.works>
2020-11-30 14:19:55 +00:00