Manage Workspaces with Rudder CLI Alpha

Manage your workspaces with Rudder CLI to streamline your development and production workflows.
Available Plans
  • free
  • starter
  • growth
  • enterprise

  •   2 minute read  

This page explains how workspace management works with Rudder CLI and how you can use import metadata to streamline your development and production workflows.

Overview

When you run the import workspace command, the generated YAML files contain special import metadata that tells Rudder CLI how to link local resources to workspace resources.

This metadata also includes workspace_id, the ID of the workspace where resources were imported from. This means that if you import resources from a development workspace, you can apply the same project to a production workspace and have the resources treated as new resources to be created rather than imported.

success
This feature allows you to experiment with new resources in a development workspace and then promote them to a production workspace.

Streamline import process with production deployment

For production environments, you can streamline the import and deployment process by integrating Rudder CLI with your CI/CD pipeline. This approach allows you to import resources once and then have your automated pipeline handle subsequent deployments.

Workflow

  1. Import resources: Run the import workspace command to generate YAML files from your workspace resources.
  2. Organize files: Place the imported files in the correct locations within your project structure.
  3. Commit to version control: Commit the organized YAML files to your repository.
  4. Automated deployment: Your CI/CD pipeline automatically applies changes using the rudder-cli apply command.
info

CI/CD integration prerequisites

Your CI/CD pipeline must use a workspace-level Service Access Token with read-write permissions to apply changes automatically.

Benefits

  • Automated deployments: Changes are applied automatically through your CI/CD pipeline.
  • Version control: All resource changes are tracked in Git.
  • Consistency: You can ensure the same resources are deployed across different environments.
  • Rollback capability: Any changes are easy to revert by leveraging Git history.

Questions? Contact us by Email or on Slack