# Github Release<no value>
// <!-- Required for asciidoctor -->
:toc:
// Set toclevels to be at least your hugo [markup.tableOfContents.endLevel] config key
:toclevels: 4

[cols="1^,1^,1^",options=header]
|===
| source | condition | target
| &#10004; | &#10004; | &#10007;
|===

== Description

**source**

The GitHub Release "source" retrieves the latest release version sorted by release date.
If no release can be found then we fallback to release tags sorted on tag date creation.
It's important to notice that both information are mutually exclusive.

== Parameter

{{< resourceparameters "sources" "githubrelease" >}}

=== Authentication

include::content/en/docs/plugins/_githubAuth.adoc[]

=== Version Filter

include::content/en/docs/plugins/_versionFilter.adoc[]

**Remark**:

It's considered a very bad practice to store credentials in an un-encrypted file.
Consider using an environment variable to store the token.


[source,yaml]
----
# source.yaml
{{<include "assets/code_example/docs/plugins/resources/github/release/updatecli.d/source.yaml">}}
----

=> Return v1.10.3

== Example

[source,yaml]
----
# updatecli.yaml
{{<include "assets/code_example/docs/plugins/resources/github/release/updatecli.d/updatecli.yaml">}}
----