August 26, 2021
New Application section
In the Design menu, the new Application section is now available.
An Application represents a useful way to instantiate and configure in an unified experience a bundle of resources including Plugins, Examples and Templates. Thus, in a few clicks, an Application can offer a working system of resources.
In the Marketplace, it is now available the Dev Portal Application, our first application.
For more info, visit the Application documentation.
Applications are available if activated when updating Mia-Platform Console. For On Premise installations, please contact your technical referent to enable the page.
A New way to navigate the Console
The user experience of navigation within the Console has been improved, gaining a greater workspace area. Some features have been introduced and some other modified:
- The main menu that allows to navigate among Areas now is in a dedicated popover that can be opened through the apposite icon in the top left corner of the Topbar. The user could also choose a bunch of shortcuts to navigate to favorite Areas that would be displayed in the Topbar. Read the Console presentation for more details.
Access to the API Portal documentation no longer occurs through the main menu, but through the relative table in the Envs section of the console. Remember that it is possible to manually customize the various links to be displayed in the table for each different runtime environment, directly through the CMS.
- The choice of the runtime environment has been standardized and it is possible to select it from the dropdown menu in the right corner of the topbar in the sections Deploy, Dashboards, Runtime and Debug. Also, the "Select Runtime Environment" card has been renamed in "Latest deployed version", and its appearance has been slightly changed.
- The branch management of the Design area is now accessible in the right corner of the topbar.
- Click on the branch name to load or create a new one,
- You can see the last time changes have been saved at the mouseover
- The circle icon shows you if there are any unsaved changes
- Use the Commit&Generate button to save your work
More information can be found in the Design documentation
- Visualize and Advanced sections of the Design area have been moved in the main sidebar, as sub-sections of "Mode" and "Workload" respectively. Please note that these sections have a dedicated button to save changes, hence the Commit&Generate in the top right corner is disabled.
Fully manageable API Gateway
The API Gateway, the core service that is responsible for:
- routing requests to the correct service inside Kubernetes;
- verify the need of authentication and orchestrate the conversation with Auth service;
is now visible in the Microservices area.
Configurations defined through the Advanced section will be inherited. From now on, the update of
api-console-config/core-service.json for the
api-gateway will not affect its configuration.
Extensions set from the API Gateway Advanced files will keep working even though the service has become a custom service.
API Gateway service is absent in your project you can now autonomously add it to your branch by creating it from the Marketplace.
API Gateway is a custom service, it is not possible to create an endpoint for it.
Only a single instance of
API Gateway can exist for each branch. If
API Gateway is already present among custom services, the marketplace will not show the
API Gateway plugin.
It is possible to set the environment variable
AUTHORIZATION_HEADERS_TO_PROXY as a comma separated list of headers which could contain the authorization token used by the user service called by the
This env variable is not required, and if it is not set the user service is called for every incoming request. If this env var is set, it brings an enhancement in performance for all APIs called without an authorization header since it avoids calling the user service: user is set as empty.
For more info, visit the Authorization service documentation
The documentation site offers now a Support page to open tickets for:
- Ideas and Improvements
- Accounts management
Real-Time Updater v3.1.2
Two new versions of the Real Time Updater have been released:
v3.1.1: a bug that prevented users to disable projections changes generation has been fixed. Now, if you set the environment variable
PROJECTIONS_CHANGES_ENABLEDto false, projections changes will not be generated when a projection is updated.
- a bug that caused delete operations to be discarded if no value was found on the database has been fixed.
- added support for delta messages in the same bulk operations set
New Systems of Record created with the Console will use Real-Time Updater services at
Real-Time Updater services already created need to be updated by hand in the dedicated detail page of the service.
Correct Deploy Outcome when interpolated variable changes version
In Deploy Area, Deploy details card, a bug that caused the Deploy Outcome to be incorrectly set to "No Update" has been fixed. The bug happened when the docker image name was dependant on a Public Variable.
Real Time Updater version at Deploy
In Deploy Area, Deploy details card, a bug that caused the
new version of a real time updater to be incorrect has been fixed.
API Gateway and Authorization Service configuration
Fixed bugs that caused the incorrect configuration of Api Gateway and Authorization Service in case the Authorization Service, Microservice Gateway, Swagger Aggregator and Api Portal:
- were set as
enabled servicesproperty of the project after their conversion to custom services, or
- were added from the Marketplace in an empty project
Swagger Aggregator and Api Portal routes
GET/ have been added to the
/documentations/api-portal endpoint of the Api Portal, and the route
GET/ has been added to the
/documentations/swagger endpoint of the Swagger Aggregator, in case they were lacking them. This has been done in order to correctly generate the Authorization Service configurations, in case the service was present in the branch.
lc39 bump to v5.0.0
In lc39 is added the support to OpenAPI 3 (set as default). For further information how to change this default and continue to expose Swagger 2, read the lc39 documentation. Added some other small fixes.
Configmap and Secret Runtime Mount Path
The validation of Runtime Mount Path for configmaps and secrets is now more permissive. It is now possible to specify paths with dots
. and other special characters.
Services choice at project creation
Core services are not chosen during project creation anymore. The ones that have been released as custom services can be added from the Marketplace, while the remaining ones can be activated by setting them to
true in the
Enabled Services property of the project through the Console CMS.
If you are using the PaaS Mia-Platform Console, two main templates are available: one with all the core services, and the other which is similar, but without CMS. More information about how to use them here.
From now on, it is not possible to create Templates using the
enabledServices property to define the presence of core services that have been migrated to custom services (i.e. crud-service, api-portal, swagger-aggregator, microservice-gateway, authorization-service, api-gateway). You will need to have them in the
api-console-config.json file at version 0.40 or higher. Existing templates using
enabledServices are still supported, no matter the services set to true, if they use
api-console-config.json with the version
0.39 or lower or do not have the file in the repository. Read the Template creation documentation for additional information.
Helidon Hello World Example
It is available a new Hello World example in Helidon that returns a hello message from the DevOps Console. Checkout Helidon Hello World Example in the Mia-Platform PaaS marketplace.
How to update your Console
For on-premise Console installations, please contact your Mia Platform referent to know how to use the
Helm chart version 4.4.1.