Managing projects

Projects are a group of database clusters within a BigAnimal organization. Access to projects is controlled by a user's role. With projects, you can separate workflows to provide secure and isolated environments and assign different users to different projects. See Managing portal access for more information.

BigAnimal projects

Projects actions are available from the left navigation bar. The actions apply to the project in focus. You can switch between projects using the Projects menu.

Adding a user to a project

Before adding a user to a project:

  • The user must be added to the organization through the organization's identity provider.
  • The user must log in to the BigAnimal portal at least once.
  • You must be an organization owner or the project owner.

To add a user:

  1. From the Projects menu, select the project you want to add a user to.
  2. From the left navigation bar, select Users.
  3. Select the edit icon for the user.
  4. Select Assign Roles.
  5. Depending on the level of access you want for the user, select the appropriate role.
  6. Select Submit.

You can enable in-app inbox or email notifications to get alerted when a user is invited to a project. For more information, see managing notifications.

Creating a project

Before creating a project:

  • You must have an organization owner role.

  • You must create a new Azure subscription or AWS account. For Google Cloud, you don't need to do so.

    Notes
    • You can use a single Azure subscription or AWS account for only one project at a time. For example, if you have two projects and only need to deploy your clusters in AWS, you need to connect a different AWS account for each project.

    • To reuse an Azure subscription or AWS account, you must first delete the project that was previously connected with that account.

  • For Google Cloud, you must create a new Google Cloud project for each BigAnimal project. To create a new Google Cloud project, see Creating and managing projects.

    Note

    Google Cloud assigns a quota to the number of Google Cloud projects based on your account type. If your account has reached its limit, you can complete a Request Project Quota Increase form or schedule for some projects to be deleted.

To create a new project:

  1. Select Projects > Create New Project.
  2. In the Project Name field, enter a unique name.
  3. Optionally, under Tags*, select +**.
  4. To assign an existing tag, in the search bar under Tags, enter a tag name. To add a new tag, instead select + Add Tag.
  5. Select Create New Project.
  6. Select Project > See All Projects.
  7. Select your new project.
  8. Set up the cloud provider for the project. See Connecting your cloud.
  9. Activate the region for the project. See Activating regions.
  10. Select Create Project.

Editing a project

To edit a project:

  1. On the Projects page, in the projects list, select the edit icon next to the project.
  2. Enter a new name.
  3. Select Update.

Deleting a project

Note

Contact BigAnimal Support if you want to delete the initial default project created by BigAnimal.

To delete a project that you created:

  1. On the Projects page, in the projects list, select the edit icon next to the project.
  2. Delete any remaining clusters in the project.
  3. Delete the regions for the project.
  4. Select Yes, Delete Project.

Adding a TDE key

  1. From the Projects page, select an existing project.
  2. Go to Settings on the left-side navigation.
  3. From the Settings list, select Security.
  4. Select Add a key.
  5. On the Add a key page, select the Cloud Service Provider.
  6. Select the Region for the key. Only the regions available in the cloud account you configured are listed.
  7. Complete the remaining fields according to your cloud provider.
  8. To finalize the configuration, select Add Key.
Note for GCP keys

If the key you added was created in a Google Cloud Platform account different from the TDE-enabled cluster you want to create, ensure you enable the Cloud KMS API in the Google console before assigning it to your cluster in BigAnimal.

Now, use this TDE key to create a cluster.

For more information about TDE support, see Transparent Data Encryption

Deleting a TDE key

  1. From the Projects page, select an existing project.

  2. Go to Settings on the left-side navigation.

  3. From the Settings list, select Security.

  4. Select a key and select the delete icon for the key you want to delete.

    You're prompted to type delete key name in the field.

  5. To delete the key, enter the text as instructed and select Yes, Delete key.

Note

A TDE key is deleted only when it isn't used and not associated with any cluster.