42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
|
# Syntaxis Tera Templates
|
||
|
|
|
||
|
|
This directory contains syntaxis-specific Tera/Jinja2 templates that override the default provctl templates.
|
||
|
|
|
||
|
|
## Files
|
||
|
|
|
||
|
|
If you need to customize Jinja2 template generation for syntaxis, add these files:
|
||
|
|
|
||
|
|
- `provisioning-config.j2` - Generate infrastructure as code configuration for provisioning
|
||
|
|
- `provctl-config.j2` - Generate service orchestration configuration for provctl
|
||
|
|
- `installer-settings.j2` - Generate installer UI configuration and deployment presets
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
By default, provctl's standard Tera templates are used. To customize for syntaxis:
|
||
|
|
|
||
|
|
1. Copy the corresponding template from provctl's config/gen/templates/tera/
|
||
|
|
2. Place it in this directory
|
||
|
|
3. Modify for syntaxis-specific needs
|
||
|
|
4. Run: `provctl gen deployment --config .provctl/gen.toml`
|
||
|
|
|
||
|
|
## Example Customization
|
||
|
|
|
||
|
|
For example, to add syntaxis-specific provisioning extensions:
|
||
|
|
|
||
|
|
```jinja2
|
||
|
|
integrations:
|
||
|
|
# Add custom provisioning integrations
|
||
|
|
syntaxis:
|
||
|
|
vapora_taskservs:
|
||
|
|
enabled: true
|
||
|
|
mode: "full"
|
||
|
|
# ... custom syntaxis extensions ...
|
||
|
|
```
|
||
|
|
|
||
|
|
## Fallback Behavior
|
||
|
|
|
||
|
|
If template files are not present here, provctl will use the default templates from:
|
||
|
|
`~/.config/provctl/gen/templates/`
|
||
|
|
|
||
|
|
This allows syntaxis to use standard templates while having the option to customize later.
|