This page describes what you can do in the Deploy view in Appian Designer.
To access this view, click Deploy in the navigation pane at the environment level or in an application.
When you access this view at the environment level, it contains information about deployments in the current environment. When you access this view from within an application, it contains information about deployments in the current application.
The Deploy view provides a single location for you to see and manage both incoming and outgoing deployments.
The following image highlights the elements that make up this view:
# |
Element |
Available Actions |
|---|---|---|
1 |
Header bar |
Learn more about the header bar. |
2 |
Navigation pane |
Learn more about the navigation pane. |
3 |
Tabs |
Go to either of the following tabs:
Each tab features a toolbar and a deployments grid. |
4 |
Toolbar |
|
5 |
Deployments grid |
To view the deployments grid, click Deploy in the navigation pane. The INCOMING tab is open by default.
The deployments history includes packages deployed using the following methods:
If you have admin permissions to the environment, you can track Admin Console setting imports in the Import History page of the Admin Console or in the Deploy view.
Note: You should no longer deploy using the Automated Import Manager. Instead, use our native deployment REST APIs. However, you can still view past deployments that used Automated Import Manager in the deploy view.
Application security and reviewer group membership determine who can see and review packages in the Deploy view.
By default, system administrators and users in the reviewer group can see all requests in the incoming and outgoing tabs. Application administrators, editors, and viewers will be able to see requests in both tabs for specific applications if they have the appropriate permissions. Application administrators and system administrators can also add a post-deployment process within a specific application.
The following table displays the available deployment activities and their permissions:
| Activity | System Administrators | Reviewer Group | Application Administrator | Application Viewers and Editors |
|---|---|---|---|---|
| View deployment history | Yes | Yes | Yes, for specific apps | Yes, for specific apps |
| View deployment request details (object names, database scripts, import customization file) | Yes | Yes | Yes, for specific apps | No |
| Approve updates to existing applications | Yes | Yes | Yes, for specific apps | No |
| Approve deployment of a new application | Yes | Yes | No | No |
| Deploy existing packages | Yes | No | Yes, for specific apps | No |
In the deployments grid, the first column of each row contains an icon indicating the deployment status.
The other columns in the grid consist of the following:
| Column | Description |
|---|---|
| Name | The name of the deployment. |
| Type | The type of deployment (Direct, Manual, or External). |
| Source | The environment from which the deployment was requested. |
| Application | The name of the application(s) included in the deployment (in the case of application deployments) or impacted by the deployment (in the case of package deployments). |
| Requested By/Submitted By | The user who initiated the deployment. |
| Requested On/Submitted On | The date the package was deployed or sent for review. |
In the Deploy view, deployment status values include the following:
Deployment Type |
Status |
Description |
|---|---|---|
Direct |
Completed |
The package has been deployed successfully. |
Completed with Errors |
The package has been deployed, but some objects had errors. |
|
Failed |
Objects in the package were not deployed because database scripts failed or did not fully execute. |
|
In Progress |
The package is currently being deployed. |
|
Pending |
The package has not been deployed yet and is waiting for review. This status will only appear when you enable deployment approvals. |
|
Rejected |
The package has been rejected by the reviewer. This status will only appear when you enable deployment approvals. |
|
Unavailable |
Information is not available because the target environment is on a different version of Appian. |
|
Manual |
Completed |
The packaged was imported/exported successfully. |
Completed with Errors |
The package was imported/exported, but some objects had errors. |
|
Failed |
No objects in the package were imported/exported due to errors. Check your deployment log. |
|
In Progress |
The package is currently being imported/exported. |
You can change the grid list as follows:
Filter: In the toolbar, select how you want to filter the list:
| Filter | Description |
|---|---|
| Type | The type of deployment (direct, manual, or external). |
| Application | Enter an application name in the search box. |
| Status | The deployment status. |
| Requested On / Submitted On | The date the package was deployed or sent for review. |
To view details of an individual deployment, click on the deployment name in the deployments grid.
The deployment details are highlighted in the following image. Some sections in the deployment details, such as DATABASE SCRIPTS (7) or DECISION (3), may not appear if they do not apply to a package or environment.
| # | Element | Description |
|---|---|---|
| 1 | Package overview | Lists the name, description, link to an external project management ticket, and post-deployment process (if one is added to the application). |
| 2 | Package details | Lists the status, deployment log link, application(s), source or target environment, requester, and requested/submitted time. |
| 3 | Decision | A reviewer can approve or reject an incoming deployment request in this section. After a decision has been confirmed, this section displays the review decision and comments. This section only appears when you enable deployment approvals. |
| 4 | Objects | The list of objects in the package, and their status when comparing them to the current environment at the time of the deployment request. You can filter the list by object type and status. |
| 5 | Plug-ins | The list of plug-ins in the package. You can filter the list by status. |
| 6 | Administration Console Settings | The Admin Console settings in the package. You must have administrator permissions to view these settings. |
| 7 | Database scripts | The download links for the database scripts. |
| 8 | Import customization file | Displays a link to download the original file or an option to upload a new file. |
| 9 | Inspection Results | Displays any missing precedents and warnings detected in the package from the most recent inspection. Inspection results are only available for direct deployments. The status will update if you click INSPECT AGAIN. |
| 10 | Pipeline | Tracks the environments to which the package has been deployed. To show up here, the environments must be connected and related deployments must have used the Deploy to Another Environment option. |
If you want to approve deployments to higher environments before they’re applied, select the Require Review option in the Admin Console. This option requires an Appian developer to approve each incoming deployment request in the environment and it also allows you to set up a reviewer group. Appian recommends creating a reviewer group to ensure that the appropriate developers have permission to approve all incoming deployments (including new applications).
System administrators, application administrators, or the specified reviewer group can comment on and approve or reject incoming deployments in the Deploy view. When a deployment is requested and approval is required, an email is sent to the application administrators and members of the reviewer group.
Once a package has been successfully deployed, you can reuse it for another environment. This is helpful for deploying packages to higher environments after testing your changes in a lower environment. The same set of changes will be applied to ensure that you are making consistent updates across all of your environments.
Learn how to deploy a package to another environment.
Deployment packages can be periodically cleaned up based on your environment's Data Retention settings. Once a package is deleted, the corresponding deployment still appears in the history, but the deployment is archived and has limited functionality.
For direct deployments, you can view a limited set of details for archived deployments. The objects list, package download, and inspection results are not available. Archived direct deployments also cannot be reviewed or deployed to another environment.
For manual deployments, details of archived deployments are not available.
Deploy View
