Templates are files that declare a desired state for InfluxDB resources. Stacks manage the mapping between templates and actual system resources. Templates can be used to reduce setup time, securely share configurations, and simplify maintenance by defining common resources like labels, buckets, and dashboard in reusable templates.

1. by: Johnny Steenbergen
influx slack: @berg
Zero to Awesome
Infrastructure with
InfluxDB Templates

2. © 2020 InfluxData. All rights reserved. 3
What are we learning today?
● TL; DR;
● Q1. What problems can templates solve?
● Q2. What are Influxdb Templates?
● Q3. How are Influxdb Templates managed?

3. © 2020 InfluxData. All rights reserved. 4
TL;DR;
● Templates
○ File that declares a desired state
○ Supports json/yaml/jsonnet
● Stack
○ Platform managed mapping
between declarative template
and state of the world
○ Can be composed of multiple
templates
○ Atomic unit of execution
● Community Templates
apiVersion: influxdata.com/v2alpha1
kind: Label
metadata:
name: label-2
---
apiVersion: influxdata.com/v2alpha1
kind: Bucket
metadata:
name: bucket-1
spec:
name: real bucket name
description: a description
retentionRules:
- type: expire
everySeconds: 3600
associations:
- kind: Label
name: label-2

4. What can templates do for you?

5. © 2020 InfluxData. All rights reserved. 6
What can templates do for you?
● A world without templates => cue time warp
> influx apply --file $TEMPLATE_FILE
● A world with templates =>

6. DEMO TIME

7. © 2020 InfluxData. All rights reserved. 9
What can templates do for you?
● Reduce setup time with a single command
> influx apply --template-url $TEMPLATE_URL
● Secure and portable Influxdb Template under source control
> influx export stack $STACK_ID
● Simplify sharing the awesome
> influx export all --filter=labelName=Storage

8. What are InfluxDB Templates?

9. © 2020 InfluxData. All rights reserved. 11
What are InfluxDB Templates?
● File or stream that declares a
desired state
● metadata.name field is unique
identifier for a resource within a
template
○ DNS-1123 compliant names
● All dependencies must be
provided
○ i.e. associated label
apiVersion: influxdata.com/v2alpha1
kind: Label
metadata:
name: label-2
---
apiVersion: influxdata.com/v2alpha1
kind: Bucket
metadata:
name: bucket-1
spec:
name: bucket name
description: a description
retentionRules:
- type: expire
everySeconds: 3600
associations:
- kind: Label
name: label-2

10. How are InfluxDB Templates managed?

11. © 2020 InfluxData. All rights reserved. 13
How are InfluxDB Templates managed?
● Stacks are the landlord of templates

12. © 2020 InfluxData. All rights reserved. 14
How are InfluxDB Templates managed?
We’d like to move in..
● Stacks are the landlord of templates
Let me check...
You’re ready to move
into stack 1A 👍

13. © 2020 InfluxData. All rights reserved. 15
How are InfluxDB Templates managed?
● Stacks are the landlord of templates
We’d like to renew...

14. © 2020 InfluxData. All rights reserved. 16
How are InfluxDB Templates managed?
Moving out...
● Stacks are the landlord of templates

15. © 2020 InfluxData. All rights reserved. 17
How are InfluxDB Templates managed?
I want to move back
in
● Stacks are the landlord of templates
What is the stack ID?I don’t recall... Ah, then you are free
to take Stack 2A

16. © 2020 InfluxData. All rights reserved. 18
How are InfluxDB Templates managed?
● Stacks are the landlord of templates
I want to move back
in

17. © 2020 InfluxData. All rights reserved. 19
How are InfluxDB Templates managed?
I want to move back
in
● Stacks are the landlord of templates
What is the stack ID?Stack 1A Ah, then you are free
to move into 1A

18. © 2020 InfluxData. All rights reserved. 20
How are InfluxDB Templates managed?
● Stacks are the landlord of templates
We’re breaking the
lease...

19. © 2020 InfluxData. All rights reserved. 21
TL;DR;
● Templates
○ File that declares a desired state
○ Supports json/yaml/jsonnet
● Stack
○ Platform managed mapping
between declarative template
and state of the world
○ Can be composed of multiple
templates
○ Atomic unit of execution
● Community Templates
apiVersion: influxdata.com/v2alpha1
kind: Label
metadata:
name: label-2
---
apiVersion: influxdata.com/v2alpha1
kind: Bucket
metadata:
name: rucket-1
spec:
name: real bucket name
description: a description
retentionRules:
- type: expire
everySeconds: 3600
associations:
- kind: Label
name: label-1

20. Community
Templates
github.com/influxdata/community-templates