cookbook 'macos', '= 2.8.1'
macos
(56) Versions
2.8.1
-
-
6.0.8
-
6.0.7
-
6.0.5
-
6.0.4
-
6.0.3
-
6.0.0
-
5.1.0
-
5.0.6
-
5.0.5
-
5.0.4
-
5.0.3
-
5.0.1
-
4.2.3
-
4.2.2
-
3.4.2
-
3.4.1
-
3.4.0
-
3.3.0
-
3.2.1
-
3.2.0
-
3.1.0
-
3.0.8
-
3.0.1
-
3.0.0
-
2.10.1
-
2.10.0
-
2.9.1
-
2.9.0
-
2.8.1
-
2.8.0
-
2.7.0
-
2.6.1
-
2.6.0
-
2.5.0
-
2.4.0
-
2.3.0
-
2.2.0
-
2.1.0
-
2.0.0
-
1.14.1
-
1.14
-
1.13.1
-
1.12.0
-
1.11.0
-
1.10.1
-
1.9.0
-
1.8.0
-
1.7.0
-
1.6.0
-
1.5.0
-
1.2.0
-
1.1.1
-
1.1.0
-
1.0.0
-
0.9.0
-
0.8.2
Follow12
- 6.0.8
- 6.0.7
- 6.0.5
- 6.0.4
- 6.0.3
- 6.0.0
- 5.1.0
- 5.0.6
- 5.0.5
- 5.0.4
- 5.0.3
- 5.0.1
- 4.2.3
- 4.2.2
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.0
- 3.2.1
- 3.2.0
- 3.1.0
- 3.0.8
- 3.0.1
- 3.0.0
- 2.10.1
- 2.10.0
- 2.9.1
- 2.9.0
- 2.8.1
- 2.8.0
- 2.7.0
- 2.6.1
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.0
- 2.1.0
- 2.0.0
- 1.14.1
- 1.14
- 1.13.1
- 1.12.0
- 1.11.0
- 1.10.1
- 1.9.0
- 1.8.0
- 1.7.0
- 1.6.0
- 1.5.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.0
- 0.9.0
- 0.8.2
Resources for configuring and provisioning macOS
cookbook 'macos', '= 2.8.1', :supermarket
knife supermarket install macos
knife supermarket download macos
macOS Cookbook
Chef resources and recipes for managing and provisioning macOS.
Supported Chef Versions
- Chef 13
- Chef 14
Supported OS Versions
- OS X El Capitan 10.11
- macOS Sierra 10.12
- macOS High Sierra 10.13
- macOS Mojave 10.14
Attributes
Admin User and Password
node['macos']['admin_user'] = 'vagrant' node['macos']['admin_password'] = 'vagrant'
Each of these attributes defaults to vagrant since our resources are developed
with the Vagrant paradigm. In other words, the user and password declared here
should be an admin user with passwordless super-user rights.
Recipes
Disable Software Updates
Disables automatic checking and downloading of software updates.
Usage: include_recipe 'macos::disable_software_updates'
No attributes used in this recipe.
Keep Awake
Prevent macOS from falling asleep, disable the screensaver, reboot upon power failure,
enable wake on LAN, enable remote login (SSH) and adjust several other settings
to always keep macOS on and available.
Usage: include_recipe 'macos::keep_awake'
| Attributes used | Default value |
|---|---|
node['macos']['remote_login_enabled'] |
true |
node['macos']['network_time_server'] |
'time.windows.com' |
node['macos']['time_zone'] |
'America/Los_Angeles' |
Xcode
Installs the latest Xcode the platform supports. See the Xcode resource documentation if you need
more flexibility.
:warning: Requires a credentials data bag containing an apple_id data bag item,
or a user/password pair set under node['macos']['apple_id'].
Usage: include_recipe 'macos::xcode'
| Attributes used | Default value |
|---|---|
node['macos']['xcode']['version'] |
'9.3' |
node['macos']['xcode']['simulator']['major_version'] |
nil |
node['macos']['apple_id']['user'] |
nil |
node['macos']['apple_id']['password'] |
nil |
Data Bags
The macos::xcode recipe can utilize a credentials data bag with an apple_id
data bag item. The item should contain valid Apple ID credentials. For example:
Example:
{
"id": "apple_id",
"apple_id": "farva@spurbury.gov",
"password": "0k@yN0cR34m"
}
Resources
Changelog
All notable changes to this project will be documented in this file.
[2.8.1] - 2018-11-29
Fixed
- Fixed an issue where the path for the
xcversionutility was hard-coded when installed as a Chef gem, which caused failures when converging with ChefDK or Workstation.
[2.8.0] - 2018-11-14
Added
- Sugar helps the code go down! We now depend on Chef Sugar for
mac_os_x?,virtual?,mac_os_x_before_or_at_maverick?, etc.
Fixed
- Fixed an issue where Software Update Catalog provides an incomplete list causing some converge failures. We now check for
platform_specific.empty?and produce appropriate errors.
[2.7.0] - 2018-10-26
Added
- Multi-converge testing added for all kitchen suites, idempotency enforced for select resources. Idempotency issues identified and resolved with the
keep_awakerecipe, thespotlightresource, and theardresource as a result. More enforcing by the idempotence police to come in future releases.
Removed
- Removal of dead links in documentation for resources to allow for more up to date and clear documentation. (Issue #129).
Fixed
- Resolved an issue with the
ardresource where a Chef run sometimes fails due to an intermittentkickstartfailure. Guards added to the default resource actions to prevent this issue. (Issue #70). - Resolved an issue with the
spotlightresource wheremdutiloutput was improperly parsed andmdutilcommands were re-ran when not needed.
[2.6.1] - 2018-10-04
Added
- The desert took its toll, the README now declares support for Mojave!
[2.6.0] - 2018-10-03
Added
Apple has limited some kickstart command functionality in macOS Mojave, preventing screen
control in some invocations. We verified theardresource's implementation of thekickstartscript still functions.Updated Xcode default version to 10.0.
The team crossed the great Mojave Desert, collapsed from dehydration, all just to obtain its support. In other words we now support macOS Mojave.
Fixed
- Prevented the
xcoderesource from leaving available Command Line Tools downloads in Software Updates.
Deprecated
- The
machine_nameresource has been deprecated in favor of the macOS support in thehostnameresource in Chef 14. It will be removed in the release of v3.0 of the macOS cookbook.
[2.5.0] - 2018-09-10
Added
- Added
CHANGELOG.md, About time right? (Issue #122). - Added functional
pathproperty to Xcode resource. (Issue #116). - Added ChefSpec resource tests for Xcode.
Fixed
- Separated extra responsibilities of Xcode resource into DeveloperAccount and CommandLineTools libraries.
[2.4.0] - 2018-08-16
Added
- Added
CHANGELOG.md. (Issue #122).
Removed
-
homebrewcookbook dependency removed.homebrew_caskandhomebrew_tapis being deprecated by Chef and has not been used bymacos-cookbooksince version2.0. (Issue #123).
Fixed
- Fixed
keychainresource documentation link. - Update
metadata_utillibrary to consider Spotlight server status before manipulating indexing state. (Issue #45).
[2.3.0] - 2018-06-28
Added
- Like a trained ninja of the night, the
macos_usernow has ahiddenproperty, making it impossible to detect from the login screen. - Moved to a new set of internal Vagrant macOS boxes, which have much more minimal initial configuration. This ensures that our resources run from a more out-of-the-box macOS experience.
Fixed
- Fixed bug where deletion of a user was failing when using the macos_user resource.
- For those of you who like to set their user and password as the same characters, we fixed an issue in the certificate resource for non-Vagrant use cases, you know for normal human beings who like a secure environment.
[2.2.0] - 2018-05-29
Added
- Foodcritics can be pretty harsh in their critiquing of food. They also have some pretty in depth rules we need to comply with, so we updated machine_name to comply with the new FoodCritic rule FC115.
- Added guard config to automatically run relevant unit tests when a file is changed.
- Update to InSpec control filenames to match the standard. This allows for better understanding of the tests.
[2.1.0] - 2018-05-16
Added
- Created an autologin functionality on 10.13.4 to allow for machine to automatically login to the machine.
[2.0.0] - 2018-05-09
Removed
- Removed the Mono recipe as it is not in the scope of this cookbook.
- Removed Apple Configurator recipe as a bug with the
masdependency does not function in High Sierra.
[1.14.0] - 2018-05-01
Added
- Updated the
keep_awakerecipe and spec tests to not require node attribute stubbing when wrapped in another cookbook.
[1.13.0] - 2018-04-25
Added
- Added a CONTRIBUTING.md to outline the Chef Community Guidelines for code contribution.
Fixed
- Fixed an issue with ChefSpec when wrapping the
keep_awakerecipe. - Fixed an idempotence issue with the keychain resource.
[1.12.0] - 2018-04-16
Added
- Added new keychain resource
- Introduced three new library classes
Power,Environment, andScreenSaver. - Updated README.md to reflect single build definition.
- Added feature to make disk sleep default to
Never.
[1.11.0] - 2018-04-11
Added
- Added the ability to install Xcode beta builds to the
xcoderesource. - Added support for Chef 14.
[1.10.0] - 2018-03-26
Added
- Added feature that allows node attributes to be set for Developer Apple ID credentials while downloading Xcode from Apple.
- Added ability to install Command Line tools from the
xcode-installgem.
Fixed
- Increased timeout for Xcode download for issue where method
bundle_version_correctfails and unsuccessfully tries to access node attributes in Xcode library. - Resolved issue where adding users and groups would fail tests.
[1.9.0] - 2018-03-21
Added
- Added support for other hypervisors and keep away logic.
- Implemented
-toption incertificateresource to allow apps to access imported key. - Add
utf-8encoding type toplistresource to make it more robust.
[1.8.0] - 2018-03-12
Added
- Added a
dns_domainproperty tomachine_nameresource to support FQDNs. - Added TESTING.md documentation.
- Changed
binaryproperty toencodingto support xml and binary plist formats.
Removed
- Removed support for
NetBIOSNamedue to macOS bugs.
Fixed
- Fixed several bugs in
plistresource. - Fixed typos in
machine_nameresource documentation.
[1.7.0] - 2018-03-05
Added
- Added the
certificateresource, this resource manages the state of a given certificate for a specified keychain.
[1.6.0] - 2018-02-20
Added
- Added whitespace support for property list names and keys.
Fixed
- Fixed some depreciation bugs in the
macos_userresource. - Fixed idempotency bug in
.kitchen.yml.
[1.5.0] - 2018-02-12
Added
- Added new
system_preferenceresource.
Removed
- Removed
systemsetupresource. - Removed
.deliveryin favor ofkitchen testand concurrency testing model.
Fixed
- Fixed issue where
plistresources cause incomplete idempotence on second converge by making thekeep_awakerecipe idempotent. (Issue #15). - Fixed issue where
macos_userwas not allowing users to be added to groups by creating a newgroupsproperty. (Issue #40). - Fixed issue where
machine_nameresource does not setLocalHostNameby makingmachine_nameidempotent and having it properly set theLocalHostName. (Issue #20).
[1.3.0] - 2018-02-02
Added
- Added helper modules for
systemsetup. - Added new attributes to adjust the
keep_awakefunctions. - Added better functionality to the
keep_awakepower resources.
[1.2.0] - 2018-01-28
Added
- Initial release of the macOS Cookbook.
- Chef support for 10.10 to 10.13.
- Added
xcoderesource. - Added
keep_awakerecipe. - Added
spotlightresource. - Added
machine_nameresource. - Added
macos_userresource.
Collaborator Number Metric
2.8.1 passed this metric
Contributing File Metric
2.8.1 passed this metric
Foodcritic Metric
2.8.1 passed this metric
No Binaries Metric
2.8.1 passed this metric
Testing File Metric
2.8.1 passed this metric
Version Tag Metric
2.8.1 passed this metric
2.8.1 passed this metric
2.8.1 passed this metric
Foodcritic Metric
2.8.1 passed this metric
No Binaries Metric
2.8.1 passed this metric
Testing File Metric
2.8.1 passed this metric
Version Tag Metric
2.8.1 passed this metric
2.8.1 passed this metric
2.8.1 passed this metric
Testing File Metric
2.8.1 passed this metric
Version Tag Metric
2.8.1 passed this metric
2.8.1 passed this metric
2.8.1 passed this metric