Getting Started¶
Reading time: 2 minutes
Navigate the UI¶
Scalr has two scopes or levels.
Account scope (green) - Admin tasks such as creating Cloud Credentials for Terraform providers, managing users and teams and setting up VCS Providers (git connections) for all the environments.
Environment scope (blue) - Create workspaces linked to VCS or for use with the CLI, and run Terraform. You can also add VCS Providers here that are specific to each environment.
The diagram below shows where objects are configured in Scalr, with some objects configurable at both scopes. Anything configured at account scope is used or inherited at environment scope.
After signup you see this screen.
You are logged in to environment scope (blue). You can get started right away here with a VCS provider and/or a workspace.
But if you need to switch to account scope (green) to add Cloud Credentials, users, teams etc, then click on the switcher in the top right corner and click on the account (green).
First Steps¶
Before using Scalr to run Terraform there are typically a few quick things you need to set up.
Cloud Credentials - Add authentication for the cloud Terraform providers which will be injected as environment variables into workspaces.
VCS Providers - Connect Scalr to your VCS for automated runs (we support all the most commonly used ones)
Grant Access - Invite users, create teams and grant access through IAM.
Environments - Create environments to host your workspaces in logically related groups.
Workspaces - This is where Terraform runs. Connect a workspace to VCS for automated runs, or use them as a backend for the CLI.
Cloud Credentials¶
At the Account scope.
Cloud credentials can be linked to environments so that the appropriate environment variables are injected into the workspaces for the associated provider. For example, if you add credentials for AWS you will get these variables in the workspaces.
You can have multiple sets of credentials with different ones linked to different environments.
See Cloud Credentials for details of setting up credentials for the major cloud providers.
VCS Providers¶
At account or environment scope you can add a VCS provider connection.
See VCS Providers for full details of configuring each type of VCS provider.
Grant Access¶
At the Account scope (green)
Users and teams are assigned access policies to give them permissions to access environments and workspaces.
Invite additional users
Create teams to enable collaboration
Grant access via access policies.
See Identity and Access Management for full details on granting access to Scalr.
Environments¶
Environments are collections of related workspaces that correspond to functional areas, SDLC stages, projects, or any grouping that is required.
The environment is where you can assign policies, credentials, registry modules, registry templates, and VCS providers that will then be available or enforced on every workspace in that environment.
All items placed at the account scope can be optionally shared across environments.
Workspaces within an environment are where Terraform configurations are run to deploy infrastructure, and where state files are stored.
At the account scope
Create environments as required
Grant access policies to enable user and team access.
Link any cloud credentials that are required.
Workspaces¶
Create the workspaces for your specific use case.
Click the relevant link below for full details.