assembler.yml
The assembler.yml
file defines the global documentation site:
environments
shared_configuration
- narrative repository configuration
- reference repository configurations
This section defines different build environments for the documentation site.
Each environment specifies configuration details such as the site URI, content source, path prefix, Google Tag Manager settings, and feature flags.
Example:
environments:
prod:
uri: https://www.elastic.co
path_prefix: docs
content_source: current
allow_indexing: true
google_tag_manager:
enabled: true
id: GTM-KNJMG2M
This section defines YAML anchors for common settings shared among multiple repositories and deployment environments.
The following example sets a unique stack
version for each of the three defined deployment environments:
stack: &stack
current: 9.0
next: 9.1
edge: main
Configures the main docs-content
repository.
Example:
narrative:
checkout_strategy: full
Configures all other repositories whose docs content should be included or referenced in the build. Each can have custom settings for branch, checkout method, etc.
Example:
references:
apm-server:
How you add a reference repository depends on its branching strategy.
To add a continuous deployment repository, define the name of the repository:
references:
my-repository:
The above configuration is equivalent to specifying.
references:
my-repository:
next: main
current: main
To add a tagged repository, configure the repo to have a fixed git reference (typically a branch) deploy the current
content source to production.
references:
my-other-repository:
next: main
current: 9.0