Skip to content

Commit

Permalink
v13 Fall Release documentation (#1724)
Browse files Browse the repository at this point in the history
* v13 Fall Release documentation

* removed unuseful img

* style improvements

* little mention about lineage capabilities

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* updating some titles

* added PS v1.3.2 improvement

* adding fall release title

* Update mia-platform-v13.mdx

* add software catalog to v13 overview

* Update mia-platform-v13.mdx

* Update v13.3.0.md

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* added images on overview

* Update docs/release-notes/mia-platform-v13.mdx

Co-authored-by: Alberto Tessarotto <[email protected]>

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Add files via upload

* Update mia-platform-v13.mdx

* Update v13.3.0.md

* Update v13.3.0.md

* Update mia-platform-v13.mdx

* add composability RN

* add BETA tag to RN v13.3.0

* updated stable versions list

* Apply suggestions from code review

fix copies

* fix links

* Mia Care marketplace updates

* Fix header

* fix links in overview

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* Update mia-platform-v13.mdx

* removed image

* Update v13.3.0.md

* added data catalog improvements

* added images

* added docs links in rn

* Update mia-platform-v13.mdx

* Update v13.3.0.md

* Update v13.3.0.md

* add some improvements to fall release docs

* Add files via upload

* add cr in runtime img

* change position of img

* Add files via upload

* Update v13.3.0.md

---------

Co-authored-by: jacoposte <[email protected]>
Co-authored-by: Marco Filippi <[email protected]>
Co-authored-by: Claudia Focchi <[email protected]>
Co-authored-by: Nicola Moretto <[email protected]>
  • Loading branch information
5 people authored Oct 23, 2024
1 parent 0e27795 commit ecf826b
Show file tree
Hide file tree
Showing 18 changed files with 257 additions and 38 deletions.
Binary file not shown.
Binary file added docs/release-notes/img/extension-manager.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/release-notes/img/marketplace-updates.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/release-notes/img/software-catalog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/release-notes/img/versioning-management.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
106 changes: 80 additions & 26 deletions docs/release-notes/mia-platform-v13.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,18 @@ sidebar_label: v13 Overview
image: "img/release-note-link-preview.png"
---

export const Highlight = ({children, color}) => (
<span
style={{
backgroundColor: color,
borderRadius: '8px',
color: '#fff',
padding: '0.3rem',
}}>
{children}
</span>
);

**Welcome to Mia-Platform v13!**

# Compose your Platform
Expand All @@ -22,6 +34,16 @@ The main benefits for the user can be summarized by the following:

Let's go in deep with the new Features:

### Extend Mia-Platform Console using... the Console! | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

We have strengthened our Platforge Extensibility Kit by adding the possibility to add extensions from Console UI and enriching the type of supported extensions. You can now extend your Console by embedding iFrames, adding External Links & composing your pages with Microfrontend Composer within a dedicated "Extensions" section, accessible to Company Owners within the Platforge section at Company level.

Customizing your Mia-Platform Console has never been so easy: simply select the type of extension, the desired Area and where to display it from the available options, then choose what you want to show your users!

To discover more about how to manage your Extensions and the types of supported extensions, head to the [Extensions documentation](/console/company-configuration/extensions.md).

![Extension Manager](img/extension-manager.png)

### Extend Frontend of Mia-Platform Console with iFrames

Extend the Console as you like.
Expand All @@ -35,14 +57,6 @@ This function is now only accessible via Application Programming Interface (API)

To learn more, please refer to the [documentation](/console/console-extensibility/overview.md).

### Managing Custom Resources through the Console

You can now manage and configure custom objects that are not part of the standard Console supported resources using the classic user interface of the Console. This feature further expands the Console domain over user's entire workloads, enabling greater operability, governance, and control over systems.

![Custom Resources](img/custom-resources.png)

To discover more, please refer to the [documentation](/console/design-your-projects/custom-resources/custom-resources.md).

### React to Console actions using Webhooks

The variety of Console events suitable for webhook configuration constantly increases, allowing you to react and build custom flows and logic each time the event occurs.
Expand All @@ -62,6 +76,28 @@ You can find the brand new plugin in the [Backstage Marketplace](https://backsta

![Backstage](img/backstage-banner.jpg)

## Infrastructure Management

### Manage Infrastructure Resources through Console

You can now manage and configure custom objects that are not part of the standard Console supported resources using the classic user interface of the Console. This feature further expands the Console domain over user's entire workloads, enabling greater operability, governance, and control over systems.

![Custom Resources](img/infrastructure-resources.png)

#### Support to all Infrastructure Resources | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

With the Fall release updates we have officially introduced the possibility to manage the provisioning of your infrastructure, configuring - at the Design level - your Infrastructure Resources.
Within the Design of your Console you can then see a new "Infrastructure" section entirely dedicated to Infrastructure as Code!

To discover more, please refer to the [documentation page](/console/design-your-projects/custom-resources/custom-resources.md) and check out some useful [use cases](/console/design-your-projects/custom-resources/use-cases.md).

#### Support of Custom Kubernetes Resources in Runtime area | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

We finalized the support for Kubernetes type Resources by introducing the possibility of monitoring such resources at Runtime once deployed.
For each resource you will be able to access its detail where you will see the respective Describe and Events that are generated, similarly to the other resources in the Runtime Area.

To discover more, you can refer to the [documentation](/console/design-your-projects/custom-resources/custom-resources.md).

## Simplify Composability

Mia-Platform Suite empowers development teams to enhance software composability by facilitating streamlined reuse and embracing scalable approaches. With Mia-Platform v13, software composability is even more NoCode!
Expand All @@ -74,40 +110,55 @@ The main benefits for the user can be summarized by the following:

Let's go in deep with the new Features:

### Enrich Meta Data and list all your data assets: Data Catalog
### Data Catalog Application | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

Mia-Platform product suite is finally enriched with a new core component, the **Data Catalog** application, an essential tool for performing Data Discovery and Data Governance on your Company data assets.

![Data Catalog home](img/data_catalog_home.png)

Mia-Platform Data Catalog serves as a centralized repository of metadata that provides a clear and detailed overview of the Company data assets, reducing time for Data Discovery and empowering Data Governance Teams with powerful metadata management features.

Thanks to Data Catalog, you can reduce Data Discovery time with advanced search capabilities, maintain adherence to numerous data management regulations and laws, such as GDPR in Europe, provide a centralized space for your teams to share data information and knowledge, and improve data quality with powerful metadata enrichment features. In addition, thanks to Data Lineage capabilities, it is possible to understand how data move and transform within your data landscape.

To find out how it works and all the benefits of Mia-Platform Data Catalog, please refer to the related [documentation](/data_catalog/overview.mdx).

Let's welcome our first release of **Data Catalog**, designed to provide the data governance teams and data analysts with a centralized location where all metadata concerning the data assets of an organization are collected.
### Software Catalog | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

Set up our Data Catalog Agent, to connect to different external sources, such as Oracle Database, Salesforce, Postgres Database, MySQL Database, Microsoft SQL Server Database, and to extract all metadata existing on your organization's System of Records.
We are excited to announce the launch of the first release of the **Software Catalog**, designed to help you track, manage, and document software across your ecosystem.
The Software Catalog provides a centralized and reliable way to access software ownership, metadata, lifecycle status, and versions, ensuring accountability throughout the company's software landscape.

Through Mia-Platform Console, it is possible to:
![software catalog overview](img/software-catalog-overview.png)

- Keep metadata up to date with the external System of Records
- Navigate data models in a centralized place
- Enrich metadata with descriptions and GDPR regulation properties for each table field
- Export your data models in .csv format
- Make metadata usable via Data Catalog API from third-party systems and custom frontends
With Mia-Platform Software Catalog, you can:
- Explore available software resources in a centralized location
- View detailed item information, including metadata, lifecycle status, versions, release notes, and availability (Global, Public, or Private)
- Seamlessly navigate between different versions of each item

![Data Catalog Architecture](img/data-catalog-architecture.png)
### Versioning management of Marketplace resources | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

To learn more, please refer to the [documentation](/runtime_suite_templates/data-catalog-agent/10_overview.md).
Version control for your Marketplace resources is now available in Mia-Platform Console. Users can manage and access different versions of Plugins and infrastructure Resources, selecting the one that best suits their needs and easily switching between versions.
If you want to discover more, head to the [dedicated section](/marketplace/add_to_marketplace/create_your_company_marketplace.md#set-controlled-versions-for-your-marketplace-resources-and-make-them-available-to-users) inside the [Company Marketplace](/marketplace/add_to_marketplace/create_your_company_marketplace.md) documentation page.

![Versioning Management](img/versioning-management.png)

### Seamless Runtime Management with Fast Data Control Plane

Mia-Platform Fast Data has been empowered with a Runtime Management solution, the **Fast Data Control Plane**.

This Fast Data suite component provides a general overview of the Fast Data pipelines released on the runtime environment, and allows to monitor and govern the execution of your Fast Data system.
From its user-friendly web interface, you can pause and resume the consumption of data streams along Fast Data pipelines with just a few clicks to strategically allocate resources consumption and efficiently utilize them during peak demand processes.
This Fast Data suite component acts as the single central access point for governing the Fast Data Runtime of your entire Company.
Fast Data Control Plane application provides a general overview of the Fast Data pipelines released on the runtime environment, and allows to monitor and govern the execution of your Fast Data system.
From its user-friendly web interface, you can pause and resume the consumption of data streams along Fast Data pipelines with just a few clicks to strategically allocate resources consumption and efficiently utilize them during peak demand processes.

![Fast Data Control Plane](img/fd-control-plane.gif)

Many are the benefits of adopting the Fast Data control plane in your Fast Data Projects, for example:

- **Optimize Resource Allocation**, by strategically pausing and resuming the consumption of data streams along the Fast Data pipelines
- **[Initial Load and Full Refresh processes management](/fast_data/concepts/data_loading.mdx)**, thanks to a user-friendly interface and without altering the configuration of your workloads deployed in runtime
- **Performance Testing and Simulation**, to simulate different scenarios for performance testing by observing your system behavior under various conditions
- **Enhanced System Reliability**, allowing you to gracefully handle unexpected situations and/or system maintenance periods while minimizing system downtime.

![Fast Data Control Plane](img/fd-control-plane.gif)

To learn more, please refer to the [documentation](/fast_data/runtime_management/overview.mdx).
To learn more, please refer to the related [documentation](/fast_data/runtime_management/overview.mdx).

### Streamline how you build your Sagas, now No-Code

Expand Down Expand Up @@ -151,9 +202,12 @@ The main benefits for the user can be summarized by the following:
- Action Advisory
- Simplify access to features

Let's go in deep with the new Features:
### AI RAG Chat application | <Highlight color="#1890FF">v13 - Fall Release</Highlight>

In this release, we have worked on an application to extend the use of AI assistance with the process of Retrieval-Augmented Generation (RAG) in a simple way. You can then configure a RAG Application chat within your project to easily set up your own chatbot. This application is featuring automatic embeddings generation from website pages.
For more information on how to configure your custom RAG Application, head to the [related tutorial](/marketplace/tutorials/create-a-rag-application.md).

### Mia-Assistant
### Let's welcome Mia-Assistant in Console!

With this release we introduce a first version of our **Mia-Assistant**, an AI-based virtual chat that will make it easier for you to discover our Mia-Platform Console and access its documentation!
Mia-Assistant will answer your questions and provide you the related Mia-Platform documentation reference, to help you retrieve all the information you need and improve your experience with our product!
Expand Down
5 changes: 3 additions & 2 deletions docs/release-notes/stable versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,5 +32,6 @@ As the transition period from one MTW to the next approaches, more precise dates
|-----------|----------------|----------------------|----------------------|
| Q1 - 2024 | v12.0.x | _January 18th, 2024_ | _April 15th, 2024_ |
| Q2 - 2024 | v12.3.x | _April 15th, 2024_ | _July 18th, 2024_ |
| Q3 - 2024 | v13.0.x | _July 18th, 2024_ | _mid-October, 2024_ |
| Q4 - 2024 | _TBD_ | _mid-October, 2024_ | _mid-January, 2025_ |
| Q3 - 2024 | v13.0.x | _July 18th, 2024_ | _October 24th, 2024_ |
| Q4 - 2024 | v13.1.x | _October 24th, 2024_ | _January 16th, 2025_ |
| Q1 - 2025 | v13.3.x | _January 16th, 2025_ | _mid-April, 2025_ |
12 changes: 2 additions & 10 deletions docs/release-notes/v13.2.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,7 @@ sidebar_label: v13.2.1
image: "img/release-note-link-preview.png"
---

_October 10th, 2024_

:::info
Mia-Platform Console v13.2.1 is **now in Preview** and will be generally available on October 24th.

Console SaaS users can try out v13.2.1 latest improvements in Preview! Open a Service Request to ask for the creation of a sandbox Company in case you do not have access to any Company.

For self-hosted installations, please read the [following guidelines](#how-to-update-your-console).
:::
_October 24th, 2024_

## Console

Expand Down Expand Up @@ -78,4 +70,4 @@ The new version `7.2.1` of the CRUD Service is available!

## How to update your Console

For self-hosted installations, please head to the [self hosted upgrade guide](/infrastructure/self-hosted/installation-chart/100_how-to-upgrade.md) or contact your Mia-Platform referent and upgrade to _Console Helm Chart_ `v13.7.4-beta.0`.
For self-hosted installations, please head to the [self hosted upgrade guide](/infrastructure/self-hosted/installation-chart/100_how-to-upgrade.md) or contact your Mia-Platform referent and upgrade to _Console Helm Chart_ `v13.7.4`.
Loading

0 comments on commit ecf826b

Please sign in to comment.