Deployment API Utilities & Scheduler
Overview
Documentation
Welcome to the Deployment API Utilities & Scheduler module!
This module is intended for managing Mendix deployment API tasks from another Mendix application.
How to use this module
Setup is easy. Install CommunityCommons and Encryption, get an API key and a PAT token (MxToken) from your developer portal (https://user-settings.mendix.com/link/developersettings) – and usage should be quite straightforward. When using the module as a full package, add the 'Snippet_Dashboard_Full' to an administrative page, fill in the config and reload the API data.
Features
- An application overview
- Environments, builds and branches per Application
- Environment logs for recent or specific dates
- Start/stop functionality, backup functionality and deployment functions per environment
- Build functionality for branch revisions
- Combined functionality of the above via Environment Deployments
- Scheduled processes that allow all aforementioned functionality to be scheduled in advance
- Process logging which can act as a basic progress console
- API error call logging to pinpoint issues
- Snippets and microflows to implement parts in your own application
- Relatively graceful degradation when the Mendix deployment services are down
- Infrastructure to fine-tune the implementation to your needs
Known issues
Various modules still use the older (existing) API endpoints. Some functionalities are only available on non-sandbox environments; these limitations are not caught by the module (but errors will be logged/displayed when the API responds with the matching error code)
Usage
The basic version of this module is designed to be run with a single configuration/user, and contains screens and flows for all aforementioned features. However, when using this module as part of a CI/CD or DTAP setup, you may want to implement multiple configs and relate data from the module to your own administrative objects. You are encouraged to extend or duplicate this module for your own needs - please leave feedback if you run into any issues or would like additional features from these or different parts of the Mendix API set!