Merge pull request ovh#4639 from ovh/vv-vitcheff-prefect-blocks

EN Create Prefect Tutorial send an email pages/platform/integrations

pages/index.md

@@ -902,6 +902,7 @@
     + [Integrations](public-cloud-integrations)
         + [Prefect](public-cloud-integrations-prefect)
             + [Prefect - Guide - Getting Started](platform/integrations/prefect_guide_01_getting_started)
+            + [Prefect - Tutorial - Emails notification with blocks and automations](platform/integrations/prefect_tuto_02_block_automation)
 + Web Cloud
     + [Domains](web-cloud-domains)
         + [Domain names](web-cloud-domains-domain-names)

pages/platform/integrations/prefect_tuto_02_block_automation/guide.en-gb.md

@@ -0,0 +1,70 @@
+---
+title: Prefect - Tutorial - Emails notification with blocks and automations
+excerpt: Discover how to send email notification through blocks and automations in Prefect Cloud
+updated: 2023-05-19
+---
+
+**Last updated 19th May 2023**
+
+## Objective
+
+The purpose of this tutorial is to show you how to send a notification (in this case an email) with Prefect Cloud. This result will be achieved through two Prefect primitives: blocks and automations. At the end of the tutorial, you will be able to send an email via Prefect. You will also be able to understand the concept of blocks and automations and how to use them.
+
+## Requirements
+
+- Basic Knowledge of Prefect.io
+- First configuration for Prefect and OVHcloud. See our [Getting started guide](/pages/platform/integrations/prefect_guide_01_getting_started) for more information
+- An email address
+
+## Instructions
+
+### Configure an Email block
+
+In Prefect, "blocks" are pre-built, reusable building blocks that encapsulate common tasks or operations. They are designed to make it easier for users to build workflows by abstracting away the underlying complexity and allowing them to focus on the high-level logic of their pipelines. Blocks can be thought of as building blocks that can be pieced together to create complex workflows. They are created and maintained by the Prefect community and can be easily shared and used by other users.
+
+To access the lists of blocks, go to your Prefect Cloud account. In the sidebar, locate the tab `Blocks` and click on it. You will be able to see a list of softwares. It can be Docker, Github, json, etc. Here, we will use the Email Block. It should be similar to this: 
+
+![image](images/email_block.png){.thumbnail}
+
+Click on the `Add +`{.action} button and fill in the block with a name and the desired email address where you will receive a notification. You can enter multiple email addresses. Once your block is created, let's see what an automation is and why it will be useful to send our email.
+
+### Configure a first automation
+
+In Prefect, as explained in their official documentation, an automation is a higher-level construct that allows you to orchestrate and automate workflows using a set of pre-defined rules and conditions. It provides an easy-to-use interface for configuring, scheduling, and monitoring the execution of workflows, making it easier for developers to manage and maintain their pipelines. Automations can be used to trigger workflows based on specific events or data conditions, schedule workflows to run at specific times or intervals, and handle errors and exceptions in a more streamlined manner.
+
+In our case, we will use automation to send a notification. Thanks to the **block Email**, we will create a notification through an automation. This automation can only be created on the Prefect cloud's UI. Custom automations can also be created directly from your Python code. Go to the sidebar of your workspace, select `Automations` and click on the `+`{.action} icon.
+
+The first step to complete is the trigger. In this example, we will send an email when the flow previously created in our [Getting Started guide](/pages/platform/integrations/prefect_guide_01_getting_started) is completed. You can fill in the page as follows:
+
+![image](images/trigger.png){.thumbnail}
+
+> [!primary]
+>
+> You can select multiple flows for an aggregated email notification.
+>
+
+Next, you will need to describe the action to be taken when your flow ends. Here, we want to send a notification, more precisely an email. Choose `Send a notification` as an action type, then choose the email block we created earlier and define the subject of the email and the body. The creation of the automation is responsive. The suggestions will vary depending on the action chosen. Your actions page should look like this:
+
+![image](images/actions.png){.thumbnail}
+
+In the last step, you have to fill in the details of your automations such as the name and the description. Choose a name and description of your choice.
+
+### Run your flow
+
+Before running the flow, ensure that you have set up your agent in Prefect. Following the [Getting Started guide](/pages/platform/integrations/prefect_guide_01_getting_started), you should be able to have the python code. Verify that you are connected to the Prefect cloud UI. If you are not sure your agent is connected to the client, run `prefect login` and connect with your credentials. Now, run the flow!
+
+```console
+python3 console.py
+```
+
+Wait until your flow is completed and check your mailbox, you will receive an email from Prefect. If you go directly on the events feed in the Prefect UI, you can see the email has been sent. Here is a picture of the event run by your automation:
+
+![image](images/result_email.png){.thumbnail}
+
+The event feed tab is a good way to see if your flow failed or not and if the automation has been processed. In our case, we also received an e-mail at the address provided.
+
+## Go further
+
+- [Official documentation for blocks in Prefect](https://docs.prefect.io/concepts/blocks/)
+- [Official documentation for automations in Prefect](https://docs.prefect.io/ui/automations/)
+- Run your first job with Prefect and the OVHcloud API: [Create your first AI pipeline with prefect](/pages/platform/integrations/prefect_tuto_03_ai_pipeline)

pages/platform/integrations/prefect_tuto_02_block_automation/meta.yaml

@@ -0,0 +1,2 @@
+id: 0b97686a-a8d2-4df2-8b42-5344c4919fb0
+full_slug: public-cloud-integrations-prefect-blocks-and-automation