0.8.4.rst 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. ==============================
  2. Salt Cloud 0.8.4 Release Notes
  3. ==============================
  4. Welcome to 0.8.4! Aside from various bug fixes, the most important improvements
  5. in this release are to the deploy scripts. Read on to see what's happened.
  6. Documentation
  7. =============
  8. The documentation for Salt Cloud can be found on Read the Docs:
  9. https://salt-cloud.readthedocs.io
  10. Download
  11. ========
  12. Salt Cloud can be downloaded and install via pypi:
  13. https://pypi.python.org/packages/source/s/salt-cloud/salt-cloud-0.8.4.tar.gz
  14. Some packages have been made available for salt-cloud and more on their
  15. way. Packages for Arch and FreeBSD are being made available thanks to the
  16. work of Christer Edwards, and packages for RHEL and Fedora are being created
  17. by Clint Savage. The Ubuntu PPA is being managed by Sean Channel. Package
  18. availability will be announced on the salt mailing list.
  19. Salt Bootstrap
  20. ==============
  21. By far the biggest change to Salt Cloud is the inclusion of the salt-bootstrap
  22. script, made possible by the genius of Alec Koumjian and Pedro Algarvio. From
  23. this point on, each release of Salt Cloud will include the latest stable
  24. version of bootstrap-salt-minion.sh in the deploy folder. This is a generic,
  25. POSIX-compliant deployment script, which autodetects your OS, and installs
  26. the latest version of Salt accordingly. For more information, see:
  27. https://github.com/saltstack/salt-bootstrap
  28. To use this deploy script explicitly, set the script option to
  29. bootstrap-salt-minion in the profile for your VM. For instance:
  30. .. code-block:: yaml
  31. aws-archlinux:
  32. provider: aws
  33. image: ami-0356da6a
  34. size: Micro Instance
  35. script: bootstrap-salt-minion
  36. ssh_username: root
  37. For those of you still using "os" in your profiles, it should be noted that
  38. this option was renamed to "script" in 0.8.2, and your configuration should
  39. be updated accordingly.
  40. Optional Script Option
  41. ======================
  42. As mentioned above, usage of the "os" argument has been deprecated in favor of
  43. the "script" argument. However, "script" is now optional. If you do not
  44. specify this option, salt-cloud will default to bootstrap-salt-minion for you.
  45. If you do not want any deployment scripts run, you still have the following
  46. options available to you.
  47. From the command line, use the --no-deploy option:
  48. .. code-block:: bash
  49. salt-cloud --no-deploy -p myprofile mymachine
  50. In the Salt Cloud configuration, set:
  51. .. code-block:: yaml
  52. deploy: False
  53. Or in the profile, set the script option to None:
  54. .. code-block:: yaml
  55. script: None
  56. Other Generic Deploy Scripts
  57. ============================
  58. If you want to be assured of always using the latest Salt Bootstrap script,
  59. there are now a few generic templates available in the deploy directory of
  60. your saltcloud source tree:
  61. .. code-block:: bash
  62. curl-bootstrap
  63. curl-bootstrap-git
  64. python-bootstrap
  65. wget-bootstrap
  66. wget-bootstrap-git
  67. These are example scripts which were designed to be customized, adapted, and
  68. refit to meet your needs. One important use of them is to pass options to
  69. the salt-bootstrap script, such as updating to specific git tags.