Welcome to cdist documentation

Contents:

• 1. cdist - usable configuration management
• 2. Why should I use cdist?
  • 2.1. Known language
  • 2.2. Powerful language
  • 2.3. More than shell scripting
  • 2.4. Zero dependency configuration management
  • 2.5. Push based distribution
  • 2.6. Highly scalable
• 3. Supported Operating Systems
• 4. How to install cdist
  • 4.1. Requirements
  • 4.2. Install cdist
• 5. How to update cdist
  • 5.1. Update the git installation
  • 5.2. Update the python package
  • 5.3. General update instructions
• 6. Support
  • 6.1. IRC
  • 6.2. Mailing list
  • 6.3. Linkedin
  • 6.4. Commercial support
• 7. Features
• 8. Quickstart
• 9. Dive into real world cdist
  • 9.1. Introduction
  • 9.2. Creating type layout
  • 9.3. Creating __sample_bottle_hosting type parameters
  • 9.4. Creating __sample_bottle_hosting type manifest
  • 9.5. Creating __sample_bottle_hosting type gencode-remote
  • 9.6. Creating __sample_nginx_http_letsencrypt_and_ssl_redirect type
  • 9.7. Creating init manifest
  • 9.8. Configuring host
  • 9.9. Creating python bottle application
  • 9.10. What's next?
• 10. cdist(1)
  • 10.1. NAME
  • 10.2. SYNOPSIS
  • 10.3. DESCRIPTION
  • 10.4. GENERAL
  • 10.5. BANNER
  • 10.6. CONFIG/INSTALL
  • 10.7. INVENTORY
  • 10.8. INVENTORY ADD-HOST
  • 10.9. INVENTORY ADD-TAG
  • 10.10. INVENTORY DEL-HOST
  • 10.11. INVENTORY DEL-TAG
  • 10.12. INVENTORY LIST
  • 10.13. PREOS
  • 10.14. PREOS DEBIAN/DEVUAN
  • 10.15. PREOS UBUNTU
  • 10.16. SHELL
  • 10.17. TRIGGER
  • 10.18. CONFIGURATION
  • 10.19. FILES
  • 10.20. NOTES
  • 10.21. EXAMPLES
  • 10.22. ENVIRONMENT
  • 10.23. EXIT STATUS
  • 10.24. AUTHORS
  • 10.25. CAVEATS
  • 10.26. COPYING
• 11. Bootstrap
  • 11.1. Location
  • 11.2. Setup working directory and branch
  • 11.3. Publishing the configuration
  • 11.4. Updating from origin
• 12. Configuration
  • 12.1. Description
  • 12.2. Config file format
• 13. Manifest
  • 13.1. Description
  • 13.2. Initial and type manifests
  • 13.3. Define state in the initial manifest
  • 13.4. Splitting up the initial manifest
  • 13.5. Dependencies
  • 13.6. Create dependencies from execution order
  • 13.7. Overrides
  • 13.8. Examples
• 14. cdist type
  • 14.1. Description
  • 14.2. Synopsis
  • 14.3. How to use a type
  • 14.4. Singleton types
  • 14.5. Config types
  • 14.6. Install types
  • 14.7. Nonparallel types
  • 14.8. How to write a new type
  • 14.9. Defining parameters
  • 14.10. Using parameters
  • 14.11. Input from stdin
  • 14.12. Writing the manifest
  • 14.13. Singleton - one instance only
  • 14.14. Install - type with install command
  • 14.15. Nonparallel - only one instance can be run at a time
  • 14.16. The type explorers
  • 14.17. Writing the gencode script
  • 14.18. Variable access from the generated scripts
  • 14.19. Environment variable usage idiom
  • 14.20. Log level in types
  • 14.21. Hints for typewriters
  • 14.22. How to include a type into upstream cdist
• 15. cdist types
  • 15.1. cdist-type__acl(7)
  • 15.2. cdist-type__apt_default_release(7)
  • 15.3. cdist-type__apt_key(7)
  • 15.4. cdist-type__apt_key_uri(7)
  • 15.5. cdist-type__apt_mark(7)
  • 15.6. cdist-type__apt_norecommends(7)
  • 15.7. cdist-type__apt_ppa(7)
  • 15.8. cdist-type__apt_source(7)
  • 15.9. cdist-type__apt_update_index(7)
  • 15.10. cdist-type__block(7)
  • 15.11. cdist-type__ccollect_source(7)
  • 15.12. cdist-type__cdist(7)
  • 15.13. cdist-type__cdist_preos_trigger(7)
  • 15.14. cdist-type__cdistmarker(7)
  • 15.15. cdist-type__check_messages(7)
  • 15.16. cdist-type__chroot_mount(7)
  • 15.17. cdist-type__chroot_umount(7)
  • 15.18. cdist-type__clean_path(7)
  • 15.19. cdist-type__config_file(7)
  • 15.20. cdist-type__consul(7)
  • 15.21. cdist-type__consul_agent(7)
  • 15.22. cdist-type__consul_check(7)
  • 15.23. cdist-type__consul_reload(7)
  • 15.24. cdist-type__consul_service(7)
  • 15.25. cdist-type__consul_template(7)
  • 15.26. cdist-type__consul_template_template(7)
  • 15.27. cdist-type__consul_watch_checks(7)
  • 15.28. cdist-type__consul_watch_event(7)
  • 15.29. cdist-type__consul_watch_key(7)
  • 15.30. cdist-type__consul_watch_keyprefix(7)
  • 15.31. cdist-type__consul_watch_nodes(7)
  • 15.32. cdist-type__consul_watch_service(7)
  • 15.33. cdist-type__consul_watch_services(7)
  • 15.34. cdist-type__cron(7)
  • 15.35. cdist-type__daemontools(7)
  • 15.36. cdist-type__daemontools_service(7)
  • 15.37. cdist-type__debconf_set_selections(7)
  • 15.38. cdist-type__directory(7)
  • 15.39. cdist-type__docker(7)
  • 15.40. cdist-type__docker_compose(7)
  • 15.41. cdist-type__docker_config(7)
  • 15.42. cdist-type__docker_secret(7)
  • 15.43. cdist-type__docker_stack(7)
  • 15.44. cdist-type__docker_swarm(7)
  • 15.45. cdist-type__dog_vdi(7)
  • 15.46. cdist-type__dot_file(7)
  • 15.47. cdist-type__file(7)
  • 15.48. cdist-type__filesystem(7)
  • 15.49. cdist-type__firewalld_rule(7)
  • 15.50. cdist-type__firewalld_start(7)
  • 15.51. cdist-type__git(7)
  • 15.52. cdist-type__go_get(7)
  • 15.53. cdist-type__golang_from_vendor(7)
  • 15.54. cdist-type__grafana_dashboard(7)
  • 15.55. cdist-type__group(7)
  • 15.56. cdist-type__hostname(7)
  • 15.57. cdist-type__hosts(7)
  • 15.58. cdist-type__install_bootloader_grub(7)
  • 15.59. cdist-type__install_chroot_mount(7)
  • 15.60. cdist-type__install_chroot_umount(7)
  • 15.61. cdist-type__install_config(7)
  • 15.62. cdist-type__install_coreos(7)
  • 15.63. cdist-type__directory(7)
  • 15.64. cdist-type__install_file(7)
  • 15.65. cdist-type__install_fstab(7)
  • 15.66. cdist-type__install_generate_fstab(7)
  • 15.67. cdist-type__install_mkfs(7)
  • 15.68. cdist-type__install_mount(7)
  • 15.69. cdist-type__install_partition_msdos(7)
  • 15.70. cdist-type__install_partition_msdos_apply(7)
  • 15.71. cdist-type__install_reboot(7)
  • 15.72. cdist-type__install_reset_disk(7)
  • 15.73. cdist-type__install_stage(7)
  • 15.74. cdist-type__install_umount(7)
  • 15.75. cdist-type__iptables_apply(7)
  • 15.76. cdist-type__iptables_rule(7)
  • 15.77. cdist-type__issue(7)
  • 15.78. cdist-type__jail(7)
  • 15.79. cdist-type__jail_freebsd10(7)
  • 15.80. cdist-type__jail_freebsd9(7)
  • 15.81. cdist-type__key_value(7)
  • 15.82. cdist-type__keyboard(7)
  • 15.83. cdist-type__letsencrypt_cert(7)
  • 15.84. cdist-type__line(7)
  • 15.85. cdist-type__link(7)
  • 15.86. cdist-type__locale(7)
  • 15.87. cdist-type__locale_system(7)
  • 15.88. cdist-type__motd(7)
  • 15.89. cdist-type__mount(7)
  • 15.90. cdist-type__mysql_database(7)
  • 15.91. cdist-type__package(7)
  • 15.92. cdist-type__package_apt(7)
  • 15.93. cdist-type__package_dpkg(7)
  • 15.94. cdist-type__package_emerge(7)
  • 15.95. cdist-type__package_emerge_dependencies(7)
  • 15.96. cdist-type__package_luarocks(7)
  • 15.97. cdist-type__package_opkg(7)
  • 15.98. cdist-type__package_pacman(7)
  • 15.99. cdist-type__package_pip(7)
  • 15.100. cdist-type__package_pkg_freebsd(7)
  • 15.101. cdist-type__package_pkg(7)
  • 15.102. cdist-type__package_pkgng_freebsd(7)
  • 15.103. cdist-type__package_rubygem(7)
  • 15.104. cdist-type__package_update_index(7)
  • 15.105. cdist-type__package_upgrade_all(7)
  • 15.106. cdist-type__package_yum(7)
  • 15.107. cdist-type__package_zypper(7)
  • 15.108. cdist-type__pacman_conf(7)
  • 15.109. cdist-type__pacman_conf_integrate(7)
  • 15.110. cdist-type__pf_apply(7)
  • 15.111. cdist-type__pf_ruleset(7)
  • 15.112. cdist-type__ping(7)
  • 15.113. cdist-type__postfix(7)
  • 15.114. cdist-type__postfix_master(7)
  • 15.115. cdist-type__postfix_postconf(7)
  • 15.116. cdist-type__postfix_postmap(7)
  • 15.117. cdist-type__postfix_reload(7)
  • 15.118. cdist-type__postgres_database(7)
  • 15.119. cdist-type__postgres_extension(7)
  • 15.120. cdist-type__postgres_role(7)
  • 15.121. cdist-type__process(7)
  • 15.122. cdist-type__prometheus_alertmanager(7)
  • 15.123. cdist-type__prometheus_exporter(7)
  • 15.124. cdist-type__prometheus_server(7)
  • 15.125. cdist-type__pyvenv(7)
  • 15.126. cdist-type__qemu_img(7)
  • 15.127. cdist-type__rbenv(7)
  • 15.128. cdist-type__rsync(7)
  • 15.129. cdist-type__rvm(7)
  • 15.130. cdist-type__rvm_gemset(7)
  • 15.131. cdist-type__rvm_gemset(7)
  • 15.132. cdist-type__rvm_ruby(7)
  • 15.133. cdist-type__ssh_authorized_key(7)
  • 15.134. cdist-type__ssh_authorized_keys(7)
  • 15.135. cdist-type__ssh_dot_ssh(7)
  • 15.136. cdist-type__staged_file(7)
  • 15.137. cdist-type__start_on_boot(7)
  • 15.138. cdist-type__sysctl(7)
  • 15.139. cdist-type__systemd_unit(7)
  • 15.140. cdist-type__timezone(7)
  • 15.141. cdist-type__update_alternatives(7)
  • 15.142. cdist-type__user(7)
  • 15.143. cdist-type__user_groups(7)
  • 15.144. cdist-type__yum_repo(7)
  • 15.145. cdist-type__zypper_repo(7)
  • 15.146. cdist-type__zypper_service(7)
• 16. Explorer
  • 16.1. Description
  • 16.2. Examples
• 17. Messaging
  • 17.1. Description
  • 17.2. Availability
  • 17.3. Examples
• 18. Parallelization
  • 18.1. Description
  • 18.2. Examples
  • 18.3. Caveats
• 19. Inventory
  • 19.1. Introduction
  • 19.2. Description
  • 19.3. cdist inventory interface
  • 19.4. Configuring hosts using inventory
  • 19.5. Examples
  • 19.6. Example of manipulating database
  • 19.7. Using external inventory
• 20. Trigger
  • 20.1. Description
• 21. PreOS
  • 21.1. Description
  • 21.2. PreOS creation
  • 21.3. Implementing new PreOS sub-command
  • 21.4. Simple tipical use case for using PreOS and trigger
• 22. cdist integration / using cdist as library
  • 22.1. Description
  • 22.2. Examples
• 23. Reference
  • 23.1. Explorers
  • 23.2. Paths
  • 23.3. Types
  • 23.4. Objects
  • 23.5. Environment variables (for reading)
  • 23.6. Environment variables (for writing)
• 24. Best practice
  • 24.1. Passwordless connections
  • 24.2. Speeding up ssh connections
  • 24.3. Speeding up shell execution
  • 24.4. Multi master or environment setups
  • 24.5. Separating work by groups
  • 24.6. Maintaining multiple configurations
  • 24.7. Multiple developers with different trust
  • 24.8. Templating
  • 24.9. Testing a new type
  • 24.10. Other content in cdist repository
• 25. Execution stages
  • 25.1. Description
  • 25.2. Stage 1: target information retrieval
  • 25.3. Stage 2: run the initial manifest
  • 25.4. Stage 3: object information retrieval
  • 25.5. Stage 4: run the object manifest
  • 25.6. Stage 5: code generation
  • 25.7. Stage 6: code execution
  • 25.8. Stage 7: cache
  • 25.9. Summary
• 26. Local cache overview
  • 26.1. Description
  • 26.2. Cache overview
• 27. Saving output streams
  • 27.1. Description
• 28. Remote exec and copy commands
• 29. Hacking
  • 29.1. Welcome
  • 29.2. Reporting bugs
  • 29.3. Coding conventions (everywhere)
  • 29.4. How to submit stuff for inclusion into upstream cdist
  • 29.5. How to submit a new type
  • 29.6. Example git workflow
• 30. Troubleshooting
  • 30.1. Error in manifest is not considered an error by cdist