Version:

Profiles IDE

Use the web-based editor in RudderStack dashboard to create and manage an end-to-end Profiles project.

The Profiles IDE is a web-based editor in the RudderStack dashboard that lets you develop your Profiles projects in a production-ready environment.

You can build your project and manage the YAML configuration files completely within the RudderStack dashboard or convert it to a version control repository like GitHub, GitLab, at any time.

Profiles IDE features

  • Develop and deploy your Profiles applications quickly within the same runtime as your production projects.
  • Modify, save, and commit changes using an intuitive editor in the RudderStack dashboard.
  • Download or manage the Profiles CLI or connect to an external Git source without any hassle.
  • Avoid managing the dependencies or Python versions on your local machine.

Use Profiles IDE

You can perform the following operations using the Profiles IDE:

  • Create a new Profiles Project: Select the Web-based editor (IDE) option in the RudderStack dashboard and follow the instructions. Once created, you can modify the inputs, build an ID graph and features, and validate outputs in your data warehouse.
  • Edit an existing Profiles Project: Edit the project even if it is stored and managed fully within RudderStack or connected to your version control repository, for example, GitHub, GitLab, etc.

In your Profiles project, navigate to Settings and click Editor mode.

Editor mode for Profiles IDE

Next, enter the schema name you want to use for development purposes for your editing session and click Continue.

info

RudderStack recommends using a development schema while editing your project so that you can modify your YAML configuration files, run your changes within the editor, and validate the outputs in a separate development schema.

This makes it convenient to test your changes in the development schema without affecting the outputs in your production schema.

Once you make the changes, you can easily commit them to your RudderStack managed production project.

If you’re using a version control repository, RudderStack will push the commits to the main branch of the remote repository so that you have full access to your commit history. This allows visibility into the historical changes, easy rollbacks, and a reliable project sourced from a repository that can be managed both from the IDE and your local environment.

FAQ

What is the difference between a RudderStack-hosted project and a Git-connected project?

RudderStack-hosted projectGit-connected project
The files are hosted completely within RudderStack.The files are stored in the repository of your version control platform.
You need not set up and connect your version control provider but you will not have access to the commit history or the ability to revert changes.You have access to your commit history and can easily rollback any changes.
info
You can convert your RudderStack hosted project to a Git repository at any point of time.

What is the difference between the save and commit operations?

Save operation: When a new session starts, the current project loads into the session’s browser storage. Any changes you save are added to the browser storage connected to that session and used during runs performed within that session. Note that the saved changes do not affect the production project.

Commit operation: Once you validate the changes and want to merge them into the production project, you can commit them to save the changes to your production project.

Why does the IDE ask me for a schema for each session?

By default, the production project writes its outputs (ID graph, feature views, etc) to a defined schema. Each session prompts you for a schema to save that session’s (or user’s) outputs to so that they are run and validated without affecting the production outputs.

info
RudderStack recommends using a separate schema for development and the production project so that the editing sessions do not interfere with connected pipelines, activations or audiences.

Multiple users can use the same or separate development schemas to work in isolation and validate outputs directly in the data warehouse.

Which Profiles versions can I run in the IDE?

The IDE sources the Profiles version in the same way as the CLI. So, RudderStack uses the version defined in your IDE configuration to run the project and it can be deployed to the production project as well.

What if multiple users make changes to the Profiles project?

All changes are tied to a user/browser session. The pushed changes will cause conflicting open sessions to reset to the commited changes.

Saving and running the changes within a given user session does not affect the production project (whether RudderStack hosted or Git hosted) until you commit them.

What if the origin changes during the editing session?

If the origin changes during an editing session(s), RudderStack pulls down and applies the remote changes before applying the editor session changes.

Do I need to provide write access to my SSH deploy key?

Yes, if you are using the IDE with a Git-connected repository, you will need to provide the write access to your SSH deploy key so that the RudderStack app can commit your changes directly to your remote Git repository.

If you did not initially provide write access, you can use a new SSH deploy key and grant write access to the repository.

Which Git URLs does the Profiles IDE support?

RudderStack supports the SSH URLs and the below ones while working with the Profiles IDE:

  • Writes to the main branch of the repository: git@<provider-host>:<org-name>/<repo-name>
  • Writes to a specific branch: git@<provider-host>:<org-name>/<repo-name>/tree/<branch-name>

RudderStack does not support the below URLs while working with Profiles IDE:

  • git@<provider-host>:<org-name>/<repo-name>/tree/branch-name/subfolder
  • git@<provider-host>:<org-name>/<repo-name>/tag/v1.0.0
  • git@<provider-host>:<org-name>/<repo-name>/commit/<commit-hash>

In addition, you can use these SSH Git URLs to read your Profiles project.

Why am I unable to see the past runs of my Profiles project in the History tab, even though I ran it through my IDE?

RudderStack stores the project runs triggered from your IDE based on your session ID, not the project ID. Hence, your past runs won’t appear in the History tab.

Why does the red dot keep showing next to my saved YAML file?

The red dot indicates that you have uncommitted changes to your file. To remove the dot, you’ll need to commit these changes to your remote repository.

Will my run history and preferences be the same if I access the same project from a different machine?

No, RudderStack ties your run history and user preferences to a specific session ID, which is unique to each machine. Therefore, accessing the same project from different machines will result in different histories and preferences.

Why can’t I see all the files in my Profiles project in the IDE?

Currently, the RudderStack IDE only supports viewing and editing the YAML and SQL files. Any other file types within your Git repository like text or image files won’t be visible in the IDE.

Can I change the Git URL of my Profiles project in the RudderStack dashboard after it’s been set up?

No, it’s not possible to modify the Git repository URL of an existing Profiles project. However, you can always create a new project with the required Git URL.



Questions? Contact us by email or on Slack