Manage Aiven for Apache Flink® applications
===========================================

This section provides information on managing your Aiven for Apache Flink® applications.

Creating a new version of an application
----------------------------------------
To create a new version of the application deployed, follow these steps: 

1. In the **Applications** tab on Aiven for Apache Flink service, select the application that contains the deployment you want to create a new version.
2. On the application landing screen, click on **Create new version**.
3. In the create new version screen, make any desired changes to the create statement, source, or sink tables. 
4. Click **Save and deploy later**. You can see the new version listed in the versions drop-down list on the left side of the screen. 
5. To deploy the new version of the application, :ref:`stop <stop-flink-application>` any existing version that is running.
6. Click **Create deployment**, and on the **Create new deployment** screen:

   * Choose the version you want to deploy. 
   * Choose the savepoint from where you want to deploy. 
   * Use the toggle for **Restart on failure** to enable or disable the option of automatically restarting a Flink job in case it fails. 
   * Enter the number of `parallel instances <https://nightlies.apache.org/flink/flink-docs-master/docs/dev/datastream/execution/parallel/>`_ you want to have for the task. 

7. Click on **Deploy from a savepoint** or **Deploy without savepoint** depending on your previous selection.


.. _stop-flink-application:

Stop application deployment
---------------------------

To stop a deployment for your Flink application, follow these steps: 

1. In the **Applications** tab on Aiven for Apache Flink service, select the application that contains the deployment you want to stop.
2. On the application landing screen, click **Stop deployment**.
3. On the **Stop deployment** screen, enable the option to **Create a savepoint before stopping** to preserve the current state of the application. 

.. note::
    To stop a deployment without saving the current state of the application, disable the option for **Create a savepoint before stopping** and select **Stop without savepoint**.

4. Click **Create savepoint & stop** to initiate the stopping process.

The application status will display ``Saving_and_stop_requested`` and then ``Finished`` once the stopping process is completed.

Additionally, you can view a history of all the application deployments and statuses by clicking **Deployment history**. 

Rename application
-------------------
To rename an application, follow these steps: 

1. In the **Applications** tab on Aiven for Apache Flink service, select the application you want to rename. 
2. On the application landing screen, click on the **Application action menu** (ellipsis) located on the right side of the screen, and select **Update application** from the menu options. 
3. In the **Update Application** screen, enter the new name for the application and click **Save changes** to confirm the new name and update the application.


.. _flink-deployment-history:

Accessing deployment history
----------------------------
The **Deployment History** screen provides the following:

* A list of all the deployments for an application 
* The user who created the application (created by)
* Data and time of creation (created at)
* Application version
* If a savepoint was created or not

To view and delete the deployment history of an application, follow these steps: 

1. In the **Applications tab** on Aiven for Apache Flink service, select the application for which you want to view the deployment history. 
2. On the application landing screen, click **Deployment History** to view the deployment history.
3. To remove a specific deployment from the history, locate it in the deployment history screen and click on the **Delete** icon next to it.

To learn about the different application statuses, see <Flink application status>

Delete application
-------------------
Before deleting an application, it is necessary to remove all associated :ref:`deployment history <flink-deployment-history>`.

1. In the **Applications tab** on Aiven for Apache Flink service, select the application you want to delete. 
2. On the application landing screen, click on the **Application action menu** (ellipsis) located on the right side of the screen, and select **Delete application** from the menu options.
3. In the **Delete Confirmation** screen, enter the name of the application and click **Confirm** to proceed with the deletion.