Using the Oracle Resource Manager to Configure Your Tenancy for Data Science

The Data Science service tenancy can be automatically configured, including OCI resources, using the OCI Resource Manager.

You can configure your tenancy with the Resource Manager using a predefined Data Science sample solution or your Terraform configuration.

Before You Begin

To configure a tenancy for the Data Science service, you must have:

  • An OCI tenancy.

  • The OCID for the compartment where you want to create your stack.

  • A user with an administrator privileges to run the Resource Manager stack or Terraform scripts.

  • Ensure that your tenancy has service limits availability for the OCI resources you want to use.

Tenancy Resources

The tenancy configuration includes these resources:

Component Description Default Name Optional? Notes
Group

OCI Users Group

DataScienceGroup

Required

All policies are granted to this group. Add users to this user group to grant them permissions.

Dynamic Group

OCI Dynamic Group

DataScienceDynamicGroup

Required

Dynamic group for Data Science resources.

Policies

OCI Security Policies

DataSciencePolicies

Required

A policy with policy statements that enable access to Data Science and related resources for the user group and dynamic group.

Vault

OCI Vault

Data Science Vault

Optional

Use Vault to store credentials rather than storing them in a Data Science Notebook.

Vault Master Key

OCI Vault Master Key

Data Science Vault Master Key

Optional

Use a Vault master key to encrypt and decrypt credentials for secured access.

Configuring a Tenancy Using a Sample Template

Configuring a tenancy using a Resource Manager Terraform configuration is creating a stack, selecting a template, providing identifying information for the new stack, and updating variables. You can always edit your stack later.

Templates are available using the Console only.

  1. Open the navigation menu and select Developer Services Under Resource Manager, select Stacks.
  2. Select a compartment you have permission to work in (on the left side of the page). The page updates to display only the resources in that compartment. If you're not sure which compartment to use, contact an administrator.
  3. Click Create Stack.
  4. Select Template.
  5. Click Select Template.
  6. Click the Service tab.
  7. Select Data Science, and then click Select Template.
  8. (Optional) Enter a Name for the new stack, or use the default.
  9. (Optional) Enter a Description.
  10. (Optional) You can use Create in Compartment to change the compartment where the stack is created. This compartment contains all the resources the stack creates.

    A compartment from the list scope is set by default.

  11. For Terraform version, select the version you want for the Terraform configuration. When only one Terraform version oa available, it's selected by default.
  12. (Optional) Enter the tag namespace (for a defined tag), key, and value to assign tags to the resource.

    To add more than one tag, select Add tag.

    Tagging describes the various tags that you can use organize and find resources including cost-tracking tags.

  13. Click Next.

    The Configure Variables panel appears variables auto-populated from the Terraform configuration for the Data Science template.

  14. Review the IAM variables and change as needed. Don't use spaces in any of the variables.
    Important

    Don't add your private key or other confidential information to configuration variables.

  15. (Optional) Select Enable Vault Support? to enable storing secrets, encrypted passwords, and keys, and then enter vault values to create a vault.
  16. Click Next and review the stack configuration.
  17. In the Review panel, verify your stack configuration.
  18. Select Run Apply to apply the Terraform script and create the Data Science resources.
  19. Click Create to create your stack.

    The resources are created and attached to the stack. This operation might take several minutes to complete.

To see a list of the Data Science resources, under Resources, click Associated Resources.

Managing Stacks and Jobs contains details about Resource Manager stacks.

Note

Alternatively, you could configure your tenancy using the script we have provided on GitHub and following the instructions in the README.md file.