0.8.1.rst 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. ==============================
  2. Salt Cloud 0.8.1 Release Notes
  3. ==============================
  4. In a somewhat quicker timeline than usual, Salt Cloud 0.8.1 has been released!
  5. While many of the updates in this release focus on stability, users of map
  6. files and AWS also have some new features to look forward to.
  7. Documentation
  8. =============
  9. The documentation for Salt Cloud can be found on Read the Docs:
  10. https://salt-cloud.readthedocs.io
  11. Download
  12. ========
  13. Salt Cloud can be downloaded and install via pypi or github:
  14. https://pypi.python.org/packages/source/s/salt-cloud/salt-cloud-0.8.1.tar.gz
  15. https://cloud.github.com/downloads/saltstack/salt-cloud/salt-cloud-0.8.1.tar.gz
  16. Some packages have been made available for salt-cloud and more on their
  17. way. Packages for Arch, and FreeBSD are being made available thanks to the
  18. work of Christer Edwards, and packages for RHEL and Fedora are being created
  19. by Clint Savage. Package availability will be announced on the salt mailing list.
  20. Full Query Option
  21. =================
  22. The -Q or --query option only displays a small amount of information about
  23. each virtual machine. This is to keep command-line reports small and
  24. manageable. Now the -F or --full-query option can be used to display all
  25. of the information about a VM that salt-cloud knows about. The amount of
  26. information returned varies between providers, depending on the kinds of
  27. functionality available through them.
  28. Increased Map Functionality
  29. ===========================
  30. Previously, map files were only used for creating VMs. Now they can also be
  31. used to query and delete VMs. The -Q, -F, and -d options can all be used in
  32. conjunction with -m, to display map-specific data. If a VM that is specified
  33. in the map does not exist, it will still show up under -Q and -F as "Absent".
  34. If a VM specified in the map does not exist when a -d is specified, it will
  35. of course be ignored.
  36. Multiple Security Groups in AWS
  37. ===============================
  38. AWS allows for multiple security groups to be applied to any given VM, but
  39. until this release, Salt Cloud only supported managing one. This update allows
  40. a list of security groups to be specified. In the main configuration file, an
  41. example of multiple security groups would look like:
  42. .. code-block:: yaml
  43. AWS.securitygroup:
  44. - default
  45. - extra
  46. In a profile, an example would be:
  47. .. code-block:: yaml
  48. micro_amazon:
  49. provider: aws
  50. image: ami-e565ba8c
  51. size: Micro Instance
  52. os: RHEL6
  53. securitygroup:
  54. - default
  55. - extra
  56. Bug Fixes
  57. =========
  58. A number of bugs have been fixed in this release. Most of these were internal
  59. fixes related to authentication and deployment across various providers. Bug
  60. fixes in this release include:
  61. Ubuntu users may notice that deploying an instance has become significantly
  62. noisier. A change was made to make Ubuntu display information returned as
  63. packages are installed, which is more aligned with how yum-based machines
  64. already behaved. This also forced these VMs to deploy salt in a much more
  65. reliable manner.
  66. Requirements listed in requirements.txt are also pulled into setup.py, to make
  67. it easy to use the easy_install tool.
  68. Most cloud providers default to root as the initial user, but AWS typically
  69. providers a different user (ec2-user, ubuntu, bitnami, etc). Deployment on
  70. such images must be handled using sudo. Previously, sudo was used to issue
  71. all deployment commands, but this failed on images where sudo was not installed
  72. by default (such as FreeBSD). Now sudo will only be used with non-root logins.