Skip to main content

Projects

When you start using Anyscale, interactive sessions, jobs and services, as well as the underlying clusters powering the applications, are all created in a default project that is accessible to the entire organization.

When the number of resources becomes large, it can be useful to organize them in projects. Creating additional projects makes it possible to group interactive sessions, jobs, services and clusters. Besides organizing resources, projects can be used to restrict access to only users that have been given permission to access them. The following diagram illustrates how projects work:

Projects

Creating and managing projects

You can create a project from the Web UI by going to the "Projects" page from the navigation menu. If you select "Blank project," you'll be able to name your project and specify whether the project should be private or public. Projects can also be created from the CLI with anyscale project create.

If you make the project private, only you will be able to access it initially. You can search for the project in this same page, and from the project page click on "Share" to add and remove collaborators, or share it with the entire organization. Collaborators can be owners (can create, view and delete resources) or read-only (can view resources but not create them).

Using projects

A project id or project name can be specified for all CLI commands that use a project (e.g., start a job or service). Alternatively, the environment variable ANYSCALE_PROJECT_NAME can be set to use a project for CLI commands and ray client, instead of specifying in the command itself. If a project is not specified for any command that uses it, the default project will be used.