During the build proccess run Flux to generate the snippets in our guides

[alisondy]

generate output of flux commands on the fly rather than manually check in output of snippets

• Folder in snippets that is all flux commands that export throughout the guide
• step in gen-content that
  • gets a container of the latest flux image
  • runs said command
  • spits the output out into another folder in snippets

involves

• modifying the make gen-content stage

priority long term, nice to have, QOL

[alisondy]

POC of this on https://github.com/alisondy/website/tree/snippet-gen

Depends on

• yq
• curl or wget

What it does

• adapted from the install.sh script
• does all the steps except for install the binary
  • check os,arch,dl,checksum,unzip
• generates snippets from configuration in gen-cli.yaml

Currently have got it working with multi line commands Need to add more logic to handle single line commands aswell

Shelving for now but if someone wants to take this on and make it more robust, feel free to.

[dholbach]

I'm not sure I understand the impact or advantage of this. Can you elaborate a little?

[alisondy]

the benefit of this is that you wouldn't have to manually go and update the snippets when flux upgrades

and that you can be certain the snippets are up to date

[dholbach]

Scott said he could take a look at integrating the relevant parts from #530.