Skip to content
This repository has been archived by the owner on Jan 29, 2024. It is now read-only.

Commit

Permalink
Merge pull request #2165 from aiven/staceys-projects-updates
Browse files Browse the repository at this point in the history
Update instructions for managing projects
  • Loading branch information
staceysalamon-aiven authored Oct 23, 2023
2 parents 122753a + 1d6d4c9 commit 8f6d80c
Showing 1 changed file with 26 additions and 30 deletions.
56 changes: 26 additions & 30 deletions docs/platform/howto/manage-project.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,55 +4,51 @@ Manage projects
Create a project
----------------

In the `Aiven web console <https://console.aiven.io/>`_, follow these steps to create a new project:
In the `Aiven Console <https://console.aiven.io/>`_, follow these steps to create a new project:

1. Click on **Project** drop down and click on **Create new project**.
2. Give the new project a name.
3. Select an Account to add the project to.
4. In **Payment method** select a project to copy the billing details from, or select **Use a new credit card**.
#. Click **Project** and select **Create project**.

When you create a new project, you will need to enable :doc:`billing for creating new services </docs/platform/howto/list-billing>`.
#. Enter a name for the project.

#. Select an organization or organizational unit to add the project to.

#. Select a :doc:`billing group </docs/platform/concepts/billing-groups>`. The costs from all services within this project will be charted to the payment method for that billing group.

.. note::
You can :ref:`create a project using the Aiven CLI <avn-create-update-project>` as well.
You can also :ref:`create a project using the Aiven CLI <avn-create-update-project>`.


Rename a project
----------------

Renaming a project is possible **only** when all the services in the project are powered-off. To rename a project in the `Aiven web console <https://console.aiven.io/>`_:

1. Select the project from the **Project** drop down.
2. Click on **Settings**.
3. Type in the new project name in the *Project Name* field.
4. Click on **Save changes**.

.. important::

- Except for Aiven for Apache Kafka®, all service types have backups which are restored once you power them back on.
- Renaming the project will invalidate all of the project's pending invitations.
- The project name in your existing DNS records will not be updated.
- Except for Aiven for Apache Kafka®, all services have backups that are restored when you power them back on.
- The project name in your DNS records will not be updated.

To rename a project in the `Aiven Console <https://console.aiven.io/>`_:

#. Power off all services in the project.
#. In the **Project**, click **Settings**.
#. Edit the **Project name**.
#. Click **Save changes**.

.. note::
You can :ref:`rename a project using the Aiven CLI <avn-create-update-project>` as well.
You can also :ref:`rename a project using the Aiven CLI <avn-create-update-project>`.

Move a project
---------------

To move a project from one organizational unit to another:

#. Open the organizational unit that has the project using the drop-down menu in the top right.

#. Click **Admin**.
To move a project from one organizational unit to another in the `Aiven Console <https://console.aiven.io/>`_:

#. Select the **Projects** tab.
#. Click **Admin** and select the organizational unit with the project you want to move.

#. Find the project you want to move and click **Move project**.
#. Click the actions menu for the project you want to move and select **Move project**.

#. Select the organizational unit that you want to move the project to.
#. Select the organizational unit that you want to move the project to. You can also move the project up a level to the organization.

.. note::
Projects cannot be moved to other organizations or to organizational units that are in other organizations.
Projects cannot be moved to other organizations. They cannot be moved to organizational units that are in other organizations.

#. Choose a billing group.

Expand All @@ -62,13 +58,13 @@ To move a project from one organizational unit to another:
Delete a project
----------------

To delete a project, you first need to delete all of the services in it. Once the services are deleted:
To delete a project in the `Aiven Console <https://console.aiven.io/>`_:

#. Select the project from the **Projects** drop down.
#. Delete all of the services in the project.

#. Click **Settings**.

#. Click **Delete project**.
#. Click **Delete**.

#. Click **Confirm**.

Expand Down

0 comments on commit 8f6d80c

Please sign in to comment.