Parallel Works

OpenStack

This page explains how to set up an OpenStack environment so that ACTIVATE can manage your OpenStack infrastructure, clusters, and usage data.

The steps on this page should be completed by a cloud engineer in your organization.

OpenStack Project

We recommend creating a dedicated OpenStack project for the ACTIVATE platform, which will allow you to keep your existing projects separate from the platform and make it easier to manage usage data. This will also ensure the principle of least privilege, as ACTIVATE will only have access to the resources it needs to manage.

Setting Up OpenStack Credentials

ACTIVATE authenticates with OpenStack using a username and password. You will need to provide the following information when adding your OpenStack cloud account in ACTIVATE:

Project Details

FieldDescription
Project IDThe unique identifier of your OpenStack project.
Project NameThe name of your OpenStack project. Some OpenStack endpoints require a project ID and others require a project name, so both are needed.
Project DomainThe domain the project belongs to. Defaults to default if not specified.

You can find your Project ID and Project Name in the OpenStack dashboard under Identity > Projects, or by running openstack project list from the CLI.

Endpoint URLs

ACTIVATE requires the following OpenStack service endpoint URLs:

FieldDescriptionExample
Identity EndpointThe Keystone identity service URL.http://example.openstack.com:5000/v3/
Compute EndpointThe Nova compute service URL.http://example.openstack.com:8774/v2.1/
Network EndpointThe Neutron network service URL.http://example.openstack.com:9696/

You can find your endpoint URLs in the OpenStack dashboard under Identity > Application Credentials, or by running openstack endpoint list from the CLI.

User Credentials

FieldDescription
UsernameThe OpenStack username for authentication.
PasswordThe password for the OpenStack user.
User DomainThe domain the user belongs to. Defaults to default if not specified.

We recommend creating a dedicated user for ACTIVATE with the appropriate roles assigned in your project. At a minimum, the user should have the member and admin roles on the project to allow ACTIVATE to manage compute, network, and storage resources.

Automatic Metadata Sync

After you add your OpenStack cloud account, ACTIVATE will automatically sync metadata from your OpenStack environment, including available regions, instance flavors, and networks. This information is used when deploying infrastructure through ACTIVATE.