salt/pkg/osx/README.md
Clayton Burlison b483d1d8a6 Update mac native package for upcoming release
This solves an issue where the package `resources` and package `scripts` were being added to the root of the install drive.

Change Spelling for:
* xCode to XCode
* and capitalize Command Line Tools

to match Apple's offical documentation.

Ref: https://developer.apple.com/xcode/
and https://developer.apple.com/library/ios/technotes/tn2339/_index.html
2016-06-01 23:32:23 -05:00

44 lines
1.4 KiB
Markdown

===============================
Building Native Packages on OSX
===============================
Salt runs well on the Mac, but does have some limitations.
In this directory you will find scripts and collateral to build an OSX
.pkg-style package that uses a custom-built Python. This process has
been tested on Mac OSX Lion (10.7) and following.
In addition, because of changes in launchd from version
to version of the OS, a simpler approach is taken for
the launchd plist files.
This approach enables Salt users to potentially
add items to their Salt install via 'pip install' without
interfering with the rest of their system's Python packages.
To build a native package you will need the following installed:
- Xcode, or the Xcode Command Line Tools
- git
The native package will install package files into /opt/salt.
Configuration files will be installed to /etc, but will have
'.dist' appended to them.
Launchd plists will be placed in /Library/LaunchDaemons. By default
salt-minion will NOT be enabled or started.
The process has been automated via the ``build.sh`` script
in the directory with this README file. Checkout the Salt repo from
GitHub, chdir into the base repo directory, and run
./build.sh
References:
http://crushbeercrushcode.org/2014/01/using-pkgbuild-and-productbuild-on-os-x-10-7/
http://stackoverflow.com/questions/11487596/making-os-x-installer-packages-like-a-pro-xcode-developer-id-ready-pkg