Deploy Tool Icon

Deploy Tool

Version:
Current
Last modified: December 30, 2019

The Deploy tool integrates with Promote, a platform for deploying, managing, and scaling predictive models. The Deploy tool uploads models directly to the Promote platform, allowing for easier visibility and management of your available predictive model resources.

Tool configuration

To deploy a model to the Promote platform:

  1. Establish an Alteryx Promote Connection.
    Alteryx Promote Connection: A drop-down list used to select from saved Promote connections.
    Add Connection: An option to add to the list of available Promote connections. The Promote connection manager operates independently of workflows.
    • Add a Promote connection
      1. Click Add Connection.
      2. In the Add Connection window, enter an Alteryx Promote URL, a URL that points to the location where your model is stored.
      3. Click Next.
      4. In the Alteryx Promote Credentials window, type your Username and API Key.
      5. Click Connect.
      6. If successful, in the Connection Established window, select Finish. The new connection is selected and visible in the drop-down.
    • Delete a Promote connection
      1. Select an available connection.
      2. Click Remove Connection.
      3. In the Confirmation window, verify the URL and Username are associated with the connection you want to remove.
      4. Click OK. The connection is no longer available in the drop-down.
  2. To deploy a model with the same name as a model in the Promote platform, select Overwrite existing model. This will update the model version to your current deployment.
    Overwritten versions are accessible through the version control within the Promote platform.
  3. Run the workflow to deploy the model to the Promote server.

Promote access

If you are unsure if you have access to the Promote feature or need assistance finding your required credentials, contact your local administrator or your support representative.

Deployment success

If the model is successfully deployed, a message displays in the Results window with the success status and model version number.

Example
Status: Successfully deploy | Version 5

If the model fails to deploy, an error message displays in the Results window.

Error message examples

  • Model already exists; check "Overwrite existing model" and re-run the workflow: Only one version of a model can be active in the Promote platform. To successfully deploy:
    • Select Overwrite existing model and re-run the workflow to deploy a new version.
    • Change the name of your model and re-run the workflow to deploy a different workflow.
  • Unable to reach API; reconfigure tool and re-run the workflow: The tool's configuration is incorrect. Verify all input information and re-run the workflow.
  • Enter valid Promote credentials: Verify that your Promote Username and API Key were entered correctly.
  • Enter valid Promote URL: Verify that you entered a valid Promote URL.
  • Promote API is unreachable; try again later: The Promote network is temporarily down.
Was This Helpful?

Need something else? Visit the Alteryx Community or contact support.