Skip to main content

Manage Builders projects

Contributors netapp-mwallis
PDFs

You can manage Builders projects to control how your code and artifacts are managed for each project in BlueXP workload factory for Builders.

Create a project

You can create a new Builders project so that you can leverage the data protection features of your Amazon FSX for NetApp ONTAP filesystem for your code and artifacts.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Create project.

  3. On the Create project page, provide the following:

    1. Project name: Enter a name for the project.

    2. Description: Enter a description for the project.

    3. Filesystem: Provide the following:

      1. Credentials: Select the Amazon AWS credentials to use. Builders uses these credentials to discover FSx for ONTAP filesystems that you can use with this project and to create clones and snapshots of projects.

      2. Region: Select the region that this FSx for ONTAP filesystem resides in.

      3. FSx for ONTAP filesystem: Select an FSx for ONTAP filesystem to use with this project.

        You can only select filesystems that are configured with a link. Learn more about links.

      4. Choose a volume: Select a volume on which to store the project; Builders uses this volume as a software repository.

        You can only select volumes that are configured as an NFS share.

    4. Operation policies: Provide limits for project clones:

      1. Maximum retention in days: Enter the maximum number of days that a clone should be retained. After this number of days, workload factory removes the clone.

      2. Maximum number of clones per user or group: Enter the maximum number of clones that can be provisioned for a user or group.

      3. Maximum clone size in GiB: Enter the maximum size in GiB of a project clone.

    5. Access policies: Explicitly grant project access to specific users or groups:

      1. Policy enforcement scope: Enter single IP addresses or IP address ranges to limit project access to only those IP addresses or ranges.

        For example: 172.16.0.0/24

      2. User or group identifiers: Enter user or group identifiers to limit project access to only those users or groups.

        For example: User1234

  4. Select Create.

Result

The project is created, and appears in the list of projects on the Projects page.

View existing projects

You can view existing projects created in BlueXP workload factory for Builders by following these steps.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Go to Projects page.

  3. View the existing projects listed on the Projects page.

Edit a project

You can edit the settings of a project at any time.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Go to Projects page.

  3. On the Projects page, select the option button for the project you want to edit.

  4. Make any needed changes to the project configuration.

  5. Select Save.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Go to Projects page.

  3. On the Projects page, select the option button for the project you want to snapshot.

  4. In the resulting menu, select Create a snapshot.

  5. In the Create snapshot dialog, choose a name for the snapshot and select Create.

View a project's workspaces

A clone or snapshot of a project is known as a workspace. When you create a workspace, it is retained for as long as the project's operation policy allows. You can view existing workspaces for a project by following these steps.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Go to Projects page.

  3. On the Projects page, choose a project and select View.

  4. View the status and details of all workspaces for this project.

  5. If you see alerts or warnings for a workspace, hover over the alert or warning icon to see the reason.

Delete a project

You can delete a project when it is no longer needed by following these steps.

Steps

  1. Log in to workload factory using one of the console experiences.

  2. In the Builders tile, select Go to Projects page.

  3. On the Projects page, select the option button for the project you want to delete.

  4. Select Delete.

  5. In the confirmation dialog, select Delete.

Result

The project is deleted, and any code or artifacts associated with the project are deleted from the volume. Snapshots and clones of the project are retained.