Installation and configuration - PeaceNlove/gispro-python-deploy-manual GitHub Wiki

Components overview

Prerequisites

  • Windows Service account for Jenkins

Installation

ArcGIS Pro

To publish mapservices, Arpcy is needed and therefore an ArcGIS Pro installation on the server is needed. Obtain the installation files from Esri. ArcGIS Pro 2.2 and 2.3 have been tested.

Install ArcGIS Pro with the default options. See licensing for more information on how this ArcGIS Pro should be licensed

Jenkins

'The leading open source automation server, Jenkins provides hundreds of plugins to support building, deploying and automating any project.'

Jenkins will be used to checkout the repositories and to run the Python scripts.

Install Jenkins with default options.

Go to Windows Services and configure the Jenkins service to run under the Service Account.

Run the powershell script. This powershell script configures Jenkins Service to interact with the desktop. This setting is only available in the services menu when the service runs under Local System Account, but this account has insufficient privileges. 'interact with the desktop' is required to get font symbology working with custom fonts. If custom fonts are used for point symbols and this 'interact with the desktop' setting is not set, the custom fonts will be replaced with default fonts and the symbology will break in the resulting mapservice.

GIT

Install the GIT client

Licensing

ArcGIS Pro has different licensing options

  • Named user: when you license ArcGIS Pro with a named user account, you need to login as the Service User to configure this. The license connection will get lost sometimes for unknown reasons and Jenkins cannot publish the service in this situation. Don't try to fix this by taking you license offline, because you might experience an error when ArcGIS Pro tries to start and you need to ask Esri support to reset your license!
  • License Server: If your organization is entitled to floating users licenses for ArcMap, you can convert Pro named user licenses to licenses which you then can configure in your license manager. This works very good with publishing automation.
  • Single license: If your organization is entitled to single licenses for ArcMap, you can convert Pro named user licenses to licenses which you then can configure in ArcGIS Pro. This works very good with publishing automation.