[{"_1":2,"_152":-5,"_153":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_131":132},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_83":-5,"_84":85,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":130},"canonicalUrl","https://hub.docker.com/r/kevinsimper/render/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","kevinsimper","reponame","render","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_37":38,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":50,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":69,"_74":11,"_75":76,"_80":28,"_81":82},"categories",[],"content_types",[39],"image","date_registered","2019-03-20T23:59:32.480502Z","description","Compile kubernetes template easily","is_private","last_updated","2019-03-22T11:26:42.52853Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[51],"application/vnd.docker.container.image.v1+json","name","pull_count",250,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# render\n\nA flexible go-template renderer.\n\n```bash\ndocker run kevin/render\n```\n\nExample:\nhttps://github.com/kevinsimper/nodejs-cloudbuild-kubernetes/blob/master/cloudbuild.yaml#L6-L12\n```\nrender -f /workspace/kubernetes/deployment.yml -var sha=$COMMIT_SHA -o /workspace\n```\n\n\n- Template definitions can be given as command-line arguments (`-template`, `-t`), or read from files (`-template-file`, `-f`, `-template-files`).\n- Variable definitions can be given as command-line arguments (`-var`), taken from the environment (`-var-env`), or read from JSON / YAML / TOML files (`-var-file`).\n\nThe template syntax is described at \n\n## Examples\n\n```bash\n$ render -f deployment.yml -var sha=$COMMIT_SHA\n```\n\n```bash\n$ render -var foo=bar -t \"value of foo: {{ .foo }}\"\nvalue of foo: bar\n```\n\n```bash\n$ echo \"{{ .SHELL }} {{ .USER }}\" | render -var-env \"\"\n/bin/bash sgreben\n```\n\n```bash\n$ echo \"{{ .env.SHELL }} {{ .env.USER }}\" | render -var-env env=\n/bin/bash sgreben\n```\n\n```bash\n$ render -var-env \"{SHELL,USER}\" -t '{{ . | toYAML }}'\nSHELL: /bin/bash\nUSER: sgreben\n```\n\n```bash\n$ render -var-files-slurp Files=\"*.toml\" -t '{{ keys .Files }}'\n[Gopkg.toml]\n```\n\n```bash\n$ echo '{ \"foo\": { \"bar\": \"baz\" } }' | render -var-file - -t \"value of foo.bar: {{ .foo.bar }}\"\nvalue of foo.bar: baz\n```\n\n```bash\n$ render -t \"{{ __RENDER_ARGS | toJSON }}\"\n[\"render\",\"-t\",\"{{ __RENDER_ARGS | toJSON }}\"]\n```\n\nA longer example demonstrating usage of multiple templates, saving CLI flags as a reusable config, and rendering templates to disk:\n\n```bash\n$ find . -type f\n./components/containers\n./components/volumes\n./templates/pod.yml\n./vars.yml\n\n$ cat templates/pod.yml\napiVersion: v1\nkind: Pod\nmetadata:\n name: {{ .name }}\nspec:\n containers: {{ template \"components/containers\" . }}\n volumes: {{ template \"components/volumes\" . }\n\n$ cat components/containers\n{{- $volumeMounts := .volumes | map \"pick\" \"name\" \"mountPath\" -}}\n{{- .containers | map \"set\" \"volumeMounts\" $volumeMounts | toJSON -}}\n\n$ cat components/volumes\n{{ .volumes | map \"omit\" \"mountPath\" | toJSON }}\n\n$ cat vars.yml\nname: my-pod\ncontainers:\n- name: nginx\n image: nginx:latest\n- name: busybox\n image: busybox\nvolumes:\n- name: data\n mountPath: /data\n emptyDir: {}\n- name: config\n mountPath: /config\n configMap:\n name: my-configmap\n\n# Generate a config file for render\n$ render -var-file vars.yml -template-files 'components/*' -template-files 'templates/*' -set-template-excludes 'components/*' -o rendered -print-config > config.json\n\n$ cat config.json\n{\n \"TemplateOutExclude\": \"components/*\",\n \"TemplateOutPath\": \"rendered\",\n \"TemplateLeftDelim\": \"{{\",\n \"TemplateRightDelim\": \"}}\",\n \"TemplateSources\": [\n {\n \"Name\": \"components/*\",\n \"FromFileGlob\": {\n \"Glob\": \"components/*\"\n }\n },\n {\n \"Name\": \"templates/*\",\n \"FromFileGlob\": {\n \"Glob\": \"templates/*\"\n }\n }\n ],\n \"VarsSources\": [\n {\n \"FromFile\": {\n \"Path\": \"vars.yml\"\n }\n }\n ]\n}\n\n# Render the templates using the config file\n$ render -config config.json\n\n$ find . -type f\n./components/containers\n./components/volumes\n./config.json\n./rendered/templates/pod.yml # this is new\n./templates/pod.yml\n./vars.yml\n\n$ cat rendered/templates/pod.yml\napiVersion: v1\nkind: Pod\nmetadata:\n name: my-pod\nspec:\n containers: [{\"image\":\"nginx:latest\",\"name\":\"nginx\",\"volumeMounts\":[{\"mountPath\":\"/data\",\"name\":\"data\"},{\"mountPath\":\"/config\",\"name\":\"config\"}]},{\"image\":\"busybox\",\"name\":\"busybox\",\"volumeMounts\":[{\"mountPath\":\"/data\",\"name\":\"data\"},{\"mountPath\":\"/config\",\"name\":\"config\"}]}]\n volumes: [{\"emptyDir\":{},\"name\":\"data\"},{\"configMap\":{\"name\":\"my-configmap\"},\"name\":\"config\"}]\n```\n\n## Tips\n\n- Variable definitions are applied in the order in which they are given on the command line / in the config file. Later definitions of the same variable override its earlier definitions.\n- Templates are loaded and rendered in the order in which they are given on the command line / in the config file. If templates with the same name are given, later definitions override earlier definitions.\n- If no template input flags are given, `render` defaults to reading a template from `stdin`.\n- If no template output flags are given, `render` defaults to rendering templates to `stdout`.\n\n## Template functions\n\nAdditionally to the functions listed at , and the functions provided by the [Sprig library](https://godoc.org/github.com/Masterminds/sprig) (except `env` and `expandenv`), the following functions are defined:\n\n- `toCSV`\n- `fromCSV`\n- `toJSON`\n- `fromJSON`\n- `toYAML`\n- `fromYAML`\n- `toTOML`\n- `fromTOML`\n- `map`\n ```go-template\n pipeline | map \"functionName\" arg0 arg1 ...\n ```\n\n produces the list\n\n ```go-template\n {\n functionName(pipeline[0], arg0, arg1, ...),\n functionName(pipeline[1], arg0, arg1, ...),\n functionName(pipeline[2], arg0, arg1, ...),\n ...\n }\n ```\n- `mapFlip` -- same as `map`, except `pipeline[i]` is provided as the *last* argument to `functionName`, not as the first.\n- `filter`\n ```go-template\n pipeline | filter \"functionName\" arg0 arg1 ...\n ```\n produces the list of all `pipeline[i]` for which `functionName(pipeline[i], arg0, arg1, ...)` returns `true`\n- `filterFlip` -- same as `filter`, except `pipeline[i]` is provided as the *last* argument to `functionName`, not as the first.\n- `__RENDER_ARGS`\n- `__RENDER_CONFIG`\n\nTo obtain a list of all defined functions, run `render -print-funcs`.\n\n## Build\n\n- Binary\n\n ```bash\n dep ensure\n make bin/render\n ```\n\n- Docker image\n\n ```bash\n make build\n ```\n\n## Usage\n\n```text\nUsage of render:\n -config value\n \tpath to a config file\n -f value\n \t(short for -template-file)\n -o string\n \t(short for -set-output-dir)\n -print-config\n \tprint config to stdout and exit\n -print-funcs\n \tprint available functions and their types to stdout and exit\n -print-templates\n \tprint rendered templates to stdout\n -print-vars\n \tprint variables to stdout and exit\n -set-config-output-file string\n \tpath to write the configuration to\n -set-left-delim string\n \tleft template delimiter (default \"{{\")\n -set-output-dir string\n \tpath to write rendered templates to\n -set-right-delim string\n \tright template delimiter (default \"}}\")\n -set-separator string\n \tseparator template to print between templates when printing templates to stdout\n -set-template-excludes string\n \texclude templates matching the given glob pattern from being output\n -set-vars-output-file string\n \tpath to write variable values to\n -t value\n \t(short for -template)\n -template value\n \tload a template passed as a parameter ([=]

kevinsimper/render

Tags for kevinsimper/render