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. cdist(1)
  • 9.1. NAME
  • 9.2. SYNOPSIS
  • 9.3. DESCRIPTION
  • 9.4. GENERAL
  • 9.5. BANNER
  • 9.6. CONFIG/INSTALL
  • 9.7. INVENTORY
  • 9.8. INVENTORY ADD-HOST
  • 9.9. INVENTORY ADD-TAG
  • 9.10. INVENTORY DEL-HOST
  • 9.11. INVENTORY DEL-TAG
  • 9.12. INVENTORY LIST
  • 9.13. SHELL
  • 9.14. CONFIGURATION
  • 9.15. FILES
  • 9.16. NOTES
  • 9.17. EXAMPLES
  • 9.18. ENVIRONMENT
  • 9.19. EXIT STATUS
  • 9.20. AUTHORS
  • 9.21. CAVEATS
  • 9.22. COPYING
• 10. Bootstrap
  • 10.1. Location
  • 10.2. Setup working directory and branch
  • 10.3. Publishing the configuration
  • 10.4. Updating from origin
• 11. Configuration
  • 11.1. Description
  • 11.2. Config file format
• 12. Manifest
  • 12.1. Description
  • 12.2. Initial and type manifests
  • 12.3. Define state in the initial manifest
  • 12.4. Splitting up the initial manifest
  • 12.5. Dependencies
  • 12.6. Create dependencies from execution order
  • 12.7. Overrides
  • 12.8. Examples
• 13. cdist type
  • 13.1. Description
  • 13.2. Synopsis
  • 13.3. How to use a type
  • 13.4. Singleton types
  • 13.5. Config types
  • 13.6. Install types
  • 13.7. Nonparallel types
  • 13.8. How to write a new type
  • 13.9. Defining parameters
  • 13.10. Using parameters
  • 13.11. Input from stdin
  • 13.12. Writing the manifest
  • 13.13. Singleton - one instance only
  • 13.14. Install - type with install command
  • 13.15. Nonparallel - only one instance can be run at a time
  • 13.16. The type explorers
  • 13.17. Writing the gencode script
  • 13.18. Variable access from the generated scripts
  • 13.19. Log level in types
  • 13.20. Hints for typewriters
  • 13.21. How to include a type into upstream cdist
• 14. cdist types
  • 14.1. cdist-type__apt_key(7)
  • 14.2. cdist-type__apt_key_uri(7)
  • 14.3. cdist-type__apt_mark(7)
  • 14.4. cdist-type__apt_norecommends(7)
  • 14.5. cdist-type__apt_ppa(7)
  • 14.6. cdist-type__apt_source(7)
  • 14.7. cdist-type__apt_update_index(7)
  • 14.8. cdist-type__block(7)
  • 14.9. cdist-type__ccollect_source(7)
  • 14.10. cdist-type__cdist(7)
  • 14.11. cdist-type__cdistmarker(7)
  • 14.12. cdist-type__chroot_mount(7)
  • 14.13. cdist-type__chroot_umount(7)
  • 14.14. cdist-type__config_file(7)
  • 14.15. cdist-type__consul(7)
  • 14.16. cdist-type__consul_agent(7)
  • 14.17. cdist-type__consul_check(7)
  • 14.18. cdist-type__consul_reload(7)
  • 14.19. cdist-type__consul_service(7)
  • 14.20. cdist-type__consul_template(7)
  • 14.21. cdist-type__consul_template_template(7)
  • 14.22. cdist-type__consul_watch_checks(7)
  • 14.23. cdist-type__consul_watch_event(7)
  • 14.24. cdist-type__consul_watch_key(7)
  • 14.25. cdist-type__consul_watch_keyprefix(7)
  • 14.26. cdist-type__consul_watch_nodes(7)
  • 14.27. cdist-type__consul_watch_service(7)
  • 14.28. cdist-type__consul_watch_services(7)
  • 14.29. cdist-type__cron(7)
  • 14.30. cdist-type__daemontools(7)
  • 14.31. cdist-type__daemontools_service(7)
  • 14.32. cdist-type__debconf_set_selections(7)
  • 14.33. cdist-type__directory(7)
  • 14.34. cdist-type__docker(7)
  • 14.35. cdist-type__docker_compose(7)
  • 14.36. cdist-type__dog_vdi(7)
  • 14.37. cdist-type__dot_file(7)
  • 14.38. cdist-type__file(7)
  • 14.39. cdist-type__filesystem(7)
  • 14.40. cdist-type__firewalld_rule(7)
  • 14.41. cdist-type__firewalld_start(7)
  • 14.42. cdist-type__git(7)
  • 14.43. cdist-type__go_get(7)
  • 14.44. cdist-type__golang_from_vendor(7)
  • 14.45. cdist-type__grafana_dashboard(7)
  • 14.46. cdist-type__group(7)
  • 14.47. cdist-type__hostname(7)
  • 14.48. cdist-type__hosts(7)
  • 14.49. cdist-type__install_bootloader_grub(7)
  • 14.50. cdist-type__install_chroot_mount(7)
  • 14.51. cdist-type__install_chroot_umount(7)
  • 14.52. cdist-type__install_config(7)
  • 14.53. cdist-type__directory(7)
  • 14.54. cdist-type__install_file(7)
  • 14.55. cdist-type__install_fstab(7)
  • 14.56. cdist-type__install_generate_fstab(7)
  • 14.57. cdist-type__install_mkfs(7)
  • 14.58. cdist-type__install_mount(7)
  • 14.59. cdist-type__install_partition_msdos(7)
  • 14.60. cdist-type__install_partition_msdos_apply(7)
  • 14.61. cdist-type__install_reboot(7)
  • 14.62. cdist-type__install_reset_disk(7)
  • 14.63. cdist-type__install_stage(7)
  • 14.64. cdist-type__install_umount(7)
  • 14.65. cdist-type__iptables_apply(7)
  • 14.66. cdist-type__iptables_rule(7)
  • 14.67. cdist-type__issue(7)
  • 14.68. cdist-type__jail(7)
  • 14.69. cdist-type__jail_freebsd10(7)
  • 14.70. cdist-type__jail_freebsd9(7)
  • 14.71. cdist-type__key_value(7)
  • 14.72. cdist-type__keyboard(7)
  • 14.73. cdist-type__letsencrypt_cert(7)
  • 14.74. cdist-type__line(7)
  • 14.75. cdist-type__link(7)
  • 14.76. cdist-type__locale(7)
  • 14.77. cdist-type__locale_system(7)
  • 14.78. cdist-type__motd(7)
  • 14.79. cdist-type__mount(7)
  • 14.80. cdist-type__mysql_database(7)
  • 14.81. cdist-type__package(7)
  • 14.82. cdist-type__package_apt(7)
  • 14.83. cdist-type__package_dpkg(7)
  • 14.84. cdist-type__package_emerge(7)
  • 14.85. cdist-type__package_emerge_dependencies(7)
  • 14.86. cdist-type__package_luarocks(7)
  • 14.87. cdist-type__package_opkg(7)
  • 14.88. cdist-type__package_pacman(7)
  • 14.89. cdist-type__package_pip(7)
  • 14.90. cdist-type__package_pkg_freebsd(7)
  • 14.91. cdist-type__package_pkg(7)
  • 14.92. cdist-type__package_pkgng_freebsd(7)
  • 14.93. cdist-type__package_rubygem(7)
  • 14.94. cdist-type__package_update_index(7)
  • 14.95. cdist-type__package_upgrade_all(7)
  • 14.96. cdist-type__package_yum(7)
  • 14.97. cdist-type__package_zypper(7)
  • 14.98. cdist-type__pacman_conf(7)
  • 14.99. cdist-type__pacman_conf_integrate(7)
  • 14.100. cdist-type__pf_apply(7)
  • 14.101. cdist-type__pf_ruleset(7)
  • 14.102. cdist-type__postfix(7)
  • 14.103. cdist-type__postfix_master(7)
  • 14.104. cdist-type__postfix_postconf(7)
  • 14.105. cdist-type__postfix_postmap(7)
  • 14.106. cdist-type__postfix_reload(7)
  • 14.107. cdist-type__postgres_database(7)
  • 14.108. cdist-type__postgres_extension(7)
  • 14.109. cdist-type__postgres_role(7)
  • 14.110. cdist-type__process(7)
  • 14.111. cdist-type__prometheus_alertmanager(7)
  • 14.112. cdist-type__prometheus_exporter(7)
  • 14.113. cdist-type__prometheus_server(7)
  • 14.114. cdist-type__pyvenv(7)
  • 14.115. cdist-type__qemu_img(7)
  • 14.116. cdist-type__rbenv(7)
  • 14.117. cdist-type__rsync(7)
  • 14.118. cdist-type__rvm(7)
  • 14.119. cdist-type__rvm_gemset(7)
  • 14.120. cdist-type__rvm_gemset(7)
  • 14.121. cdist-type__rvm_ruby(7)
  • 14.122. cdist-type__ssh_authorized_key(7)
  • 14.123. cdist-type__ssh_authorized_keys(7)
  • 14.124. cdist-type__ssh_dot_ssh(7)
  • 14.125. cdist-type__staged_file(7)
  • 14.126. cdist-type__start_on_boot(7)
  • 14.127. cdist-type__sysctl(7)
  • 14.128. cdist-type__systemd_unit(7)
  • 14.129. cdist-type__timezone(7)
  • 14.130. cdist-type__update_alternatives(7)
  • 14.131. cdist-type__user(7)
  • 14.132. cdist-type__user_groups(7)
  • 14.133. cdist-type__yum_repo(7)
  • 14.134. cdist-type__zypper_repo(7)
  • 14.135. cdist-type__zypper_service(7)
• 15. Explorer
  • 15.1. Description
  • 15.2. Examples
• 16. Messaging
  • 16.1. Description
  • 16.2. Availability
  • 16.3. Examples
• 17. Parallelization
  • 17.1. Description
  • 17.2. Examples
  • 17.3. Caveats
• 18. Inventory
  • 18.1. Introduction
  • 18.2. Description
  • 18.3. cdist inventory interface
  • 18.4. Configuring hosts using inventory
  • 18.5. Examples
  • 18.6. Example of manipulating database
  • 18.7. Using external inventory
• 19. cdist integration / using cdist as library
  • 19.1. Description
  • 19.2. Examples
• 20. Reference
  • 20.1. Explorers
  • 20.2. Paths
  • 20.3. Types
  • 20.4. Objects
  • 20.5. Environment variables (for reading)
  • 20.6. Environment variables (for writing)
• 21. Best practice
  • 21.1. Passwordless connections
  • 21.2. Speeding up ssh connections
  • 21.3. Speeding up shell execution
  • 21.4. Multi master or environment setups
  • 21.5. Separating work by groups
  • 21.6. Maintaining multiple configurations
  • 21.7. Multiple developers with different trust
  • 21.8. Templating
  • 21.9. Testing a new type
  • 21.10. Other content in cdist repository
• 22. Execution stages
  • 22.1. Description
  • 22.2. Stage 1: target information retrieval
  • 22.3. Stage 2: run the initial manifest
  • 22.4. Stage 3: object information retrieval
  • 22.5. Stage 4: run the object manifest
  • 22.6. Stage 5: code generation
  • 22.7. Stage 6: code execution
  • 22.8. Stage 7: cache
  • 22.9. Summary
• 23. Remote exec and copy commands
• 24. Hacking
  • 24.1. Welcome
  • 24.2. Reporting bugs
  • 24.3. Coding conventions (everywhere)
  • 24.4. How to submit stuff for inclusion into upstream cdist
  • 24.5. How to submit a new type
  • 24.6. Example git workflow
• 25. Troubleshooting
  • 25.1. Error in manifest is not considered an error by cdist