search

jenkinsci / configuration-as-code-plugin

Jenkins Configuration as Code Plugin
https://plugins.jenkins.io/configuration-as-code
MIT License
2.7k stars 720 forks source link

Jobs: "file" is undocumented #2509

Closed cowlinator closed 5 months ago

cowlinator commented 5 months ago

Describe your use-case which is not covered by existing documentation.

Jobs:
  - file:

is undocumented.

Reference any relevant documentation, other materials or issues/pull requests that can be used for inspiration.

The only clue that this exists is in one obscure file: https://github.com/jenkinsci/configuration-as-code-plugin/blob/269ee49a18d72419762db65d0dec3a04ccd5eba1/integrations/src/test/resources/io/jenkins/plugins/casc/SeedJobTest_withSecurityConfig.yml#L6

At the very least, add this as an example to the demos page

cowlinator commented 5 months ago

Also, are there any other hidden variants? Maybe a 

Jobs:
  - url:

or something? That would be good to know.

timja commented 5 months ago

Its documented on the plugins wiki: https://github.com/jenkinsci/job-dsl-plugin/wiki/JCasC