This repository has been archived by the owner on Jan 29, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 51
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #2218 from aiven/staceys-create-orgs-style-guide-u…
…pdates Update instructions and align with style guide
- Loading branch information
Showing
1 changed file
with
13 additions
and
19 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,53 +1,47 @@ | ||
Create organizations and organizational units | ||
============================================== | ||
|
||
**Organizations** and **organizational units** (or **units**) can be used to group projects and apply common settings like authentication and access for groups of users. For details and recommendations on creating hierarchical organizations in Aiven, see :doc:`Organizations, projects, and managing access permissions </docs/platform/concepts/projects_accounts_access>`. | ||
Organizations and organizational units can be used to group projects and apply common settings like authentication and access for groups of users. For details and recommendations on creating hierarchical organizations in Aiven, see the article on :doc:`organizations, units, and projects </docs/platform/concepts/projects_accounts_access>`. When you sign up for Aiven, an organization is automatically created for you. | ||
|
||
Create an organizational unit | ||
--------------------------------- | ||
------------------------------ | ||
|
||
You can create an organizational unit within an organization to group your projects by things like your departments or environments. To create an organizational unit: | ||
You can create an organizational unit within an organization to group your projects by, for example, your departments or environments. To create an organizational unit in the `Aiven Console <https://console.aiven.io>`_: | ||
|
||
#. In the organization where you want to create an organizational unit, click **Admin**. | ||
|
||
#. In the **Organizational units** section, click **Create organizational unit**. | ||
|
||
#. Enter a name for the unit. | ||
|
||
#. Select any projects that you want to assign to this organizational unit. You can search for projects by name. | ||
|
||
#. If you want to invite admin users to the unit, set the toggle to **Yes** and enter their email addresses. They will receive an email invitation with a confirmation link. | ||
|
||
.. important:: Admin have full control over the organizational unit and the projects assigned to it. | ||
#. Optional: Select any projects that you want to assign to this organizational unit. You can search for projects by name. | ||
|
||
#. Click **Create organizational unit**. | ||
|
||
Your organizational unit is shown in the **Organizational units** section. Click the unit name to view and manage it's groups and projects. | ||
Your organizational unit is shown in the list. Click the unit name to view and manage its projects. | ||
|
||
.. note:: | ||
Only one level of nesting is supported. This means that organizational units cannot be created within other units. | ||
|
||
|
||
Create an organization | ||
-------------------------- | ||
----------------------- | ||
|
||
.. important:: | ||
We recommend using **only one organization** and creating organizational units to group your projects. | ||
We recommend using only one organization and using organizational units to group your projects. | ||
|
||
Creating a new organization requires you to manually configure organization-level settings again such as :doc:`billing groups, authentication settings, and groups </docs/platform/concepts/projects_accounts_access>`. | ||
|
||
#. Click the user information icon and select **Organizations**. | ||
To create an organization in the `Aiven Console <https://console.aiven.io>`_: | ||
|
||
#. On the **Organizations** tab of the **User profile**, click **Create organization**. | ||
#. Click the user information icon in the top right and select **Organizations**. | ||
|
||
#. Enter a name for the organization. | ||
#. Click **Create organization**. | ||
|
||
#. Select any projects that you want to assign to this organization. You can search for projects by name. | ||
#. Select the checkbox to confirm that you understand the effects of creating an organization. | ||
|
||
#. If you want to invite admin users to the organization, set the toggle to **Yes** and enter their email addresses. They will receive an email invitation with a confirmation link. | ||
#. Enter a name for the organization. | ||
|
||
.. important:: Admin users have full control over the organization and the projects assigned to it after they accept the invitation,. | ||
#. Optional: Select any projects that you want to assign to this organization. You can search for projects by name. | ||
|
||
#. Click **Create organization**. | ||
|
||
The **Admin** page opens, where you can add organizational units, and manage groups, projects, and other settings. |