ccp-recipes

AutoPkg recipes for Creative Cloud Packager workflows

Overview

These processors and recipes may be used to automate the creation of Adobe Creative Cloud Packager (CCP) packages, using Adobe's provided automation support. Currently there are three flavors of CreativeCloudApp recipes provided:

pkg

Uses CCP to build a package saved to disk, exactly as one would using the CCP GUI application.

munki

Use the pkg recipe, wrap both the installer and uninstaller in DMGs, and import these to a Munki repo.

jss

Use the pkg recipe, and use the JSSImporter processor to import the install & uninstall packages into a Jamf Pro instance, with the required policies created.

Getting Started

Prerequisites

• AutoPkg
• Adobe Creative Cloud Packager (CCP) for macOS
• An Adobe ID which is able to sign into either the Teams or Enterprise dashboards and has the ability to build packages (for Enterprise this is at least the Deployment Admin role)
• You must run CCP once manually in order to sign in as the account/organization you will be using to create further packages.
• This recipe repo must be added to AutoPkg.
• There must be no other Adobe CC applications or the Creative Cloud application installed on the machine building packages.

Verifying your login

First log into the CCP with your username and verify that you're able to select the appropriate organization type (Teams or Enterprise) and build a package. If your Adobe ID is part of several organizations, make sure to select the one you want to be associated with the AutoPkg-built packages.

Determining your organization name

The CCP automation support requires us to specify the actual full name of the organization to which the user belongs as part of the initial authentication to build packages. There is a script in this repo, whats_my_org.sh, which will attempt to scrape the organization name from the most recent login from the CCP application logs. If this fails, you can determine the organization name by looking in the upper-left in the Teams dashboard or the upper-right in the Enterprise dashboard.

Creating the overrides

As a rule, this repository does not contain recipes for each individual product, because each organization will require different things. There are some examples provided however.

As an example, we will be creating an override recipe for Photoshop CC 2017.

In Terminal, run:

autopkg make-override -n PhotoshopCC2017.pkg CreativeCloudApp.pkg

AutoPkg will create an override file in your RecipeOverrides folder. Edit the resulting file with a text editor of your choice.

The minimum amount of information you need to put in the override is:

• Your organization name: The name described above in 'Determining your organization name'

• An application SAP code: This is a 3-4 letter code which you can find by running the listfeed.py script in this repo. Every application and any related update has an SAP code.

• A base version: The base version defines the major version for a given application. The base version and the SAP code, together, uniquely identify any Adobe application.

  For the example of Photoshop CC 2017, running listfeed.py currently shows this in the output:

  SAP Code: PHSP
      <...lines omitted...>
  	Photoshop CC (2015.5)       BaseVersion: 17.0       Version: 17.0
  	Photoshop CC (2015.5)       BaseVersion: 17.0       Version: 17.0.1
  	Photoshop CC (2015.5)       BaseVersion: 17.0       Version: 17.0.2
  	Photoshop CC (2017)         BaseVersion: 18.0       Version: 18.0
  	Photoshop CC (2017)         BaseVersion: 18.0       Version: 18.0.1
  	Photoshop CC (2017)         BaseVersion: 18.0       Version: 18.1
      Photoshop CC (2017)			BaseVersion: 18.0		Version: 18.1.1
  

  Notice how BaseVersion changes only with a major marketing version number change. Some products use BaseVersion values like 18.0, others like 14.0.0. Take care to specify these values exactly as they appear in the output of listfeed.py.

The ccpinfo Input

The only input is ccpinfo which describes how your package should be built and what is included.

You must have at least an organizationName, sapCode and some version information.

Example:

<key>ccpinfo</key>
<dict>
    <key>matchOSLanguage</key>
    <true/>
    <key>rumEnabled</key>
    <true/>
    <key>updatesEnabled</key>
    <false/>
    <key>appsPanelEnabled</key>
    <true/>
    <key>adminPrivilegesEnabled</key>
    <true/>
    <key>is64Bit</key>
    <true/>
    <key>organizationName</key>
    <string>ADMIN_PLEASE_CHANGE</string>
    <key>customerType</key>
    <string>team</string>
    <key>Language</key>
    <string>en_US</string>
    <key>Products</key>
    <array>
        <dict>
            <key>sapCode</key>
            <string>PHSP</string>
            <key>baseVersion</key>
            <string>18.0</string>
            <key>version</key>
            <string>latest</string>
        </dict>
    </array>
</dict>

Worth noting above is the version key, which is set here to latest (which is also the default if omitted). This can instead be set to the original base version if you'd like to build that version instead. Currently it does not seem like CCP will allow you to build any additional versions that may be "in between" the original release and the current latest.

As Products is an array, multiple applications or included updates may also be included in a single package. It's not recommended to deploy multiple applications via a single package, however, so child recipes (i.e. .munki) that try to import packages with multiple products may have undefined behaviour. This capability exists for cases where one wants to build a "collection" package with multiple items. Currently, the support for building packages with multiple products is experimental.

The ccpinfo dict mirrors the format of the Creative Cloud Packager Automation XML file. The format of this file is described further in This Adobe Article

Troubleshooting

• Most CCP related errors will return a validation error, even though they may be completely unrelated to validation. You should check the PDApp.log file to get to the real cause of the problem.

• You may see an error if there is a new CCP update pending. You will need to launch CCP manually to perform the update before you can proceed.

Other links

• Creative Cloud Desktop App release notes