Sha256: a51e2474bd9f0cb0fed8769f3e3769aaa2b20ae73ec4cdf73d5fa455dc569f5d
Contents?: true
Size: 1.86 KB
Versions: 47
Compression:
Stored size: 1.86 KB
Contents
# Test plugin: `idempotence`
The `idempotence` test plugin checks that a node can be checked successfully after being deployed, and that tasks are not reporting any divergence.
Only 1 node per combination of services will be tested by this test plugin, as the goal is to validate the configuration recipes/playbooks by deploying on newly-provisioned nodes for test, and not on the real nodes.
## Config DSL extension
### `ignore_idempotence_tasks`
`ignore_idempotence_tasks` defines a list of tasks that may not be idempotent during tests (meaning that checking after deploying return differences for those tasks). In such cases, those tasks will not be reported as errors by the idempotence tests.
It takes a `Hash<String, String>` as a parameter, as a set of `<task_name>` => `<descriptive_reason_for_ignore>`.
Example:
```ruby
ignore_idempotence_tasks({
'DNS - Create config' => '/etc/resolv.conf can\'t be changed in Docker test nodes, so checking always report it as different'
})
```
### `ignore_divergent_tasks`
`ignore_divergent_tasks` defines a list of tasks that may be divergent (meaning that checking nodes can return differences for those tasks). In such cases, those tasks will not be reported as errors by the idempotence or divergence tests.
It takes a `Hash<String, String>` as a parameter, as a set of `<task_name>` => `<descriptive_reason_for_ignore>`.
Example:
```ruby
for_nodes('scheduler_node') do
ignore_divergent_tasks({
'Jenkins - Create config' => 'Config file is reindented by Jenkins, so always appears different',
'Jenkins - Restart' => 'Jenkins is always restarted as config file is different when deploying'
})
end
```
## Used credentials
| Credential | Usage
| --- | --- |
## Used Metadata
| Metadata | Type | Usage
| --- | --- | --- |
## Used environment variables
| Variable | Usage
| --- | --- |
## External tools dependencies
None
Version data entries
47 entries across 47 versions & 1 rubygems