Version:

Import Profiles Project from Git

Import an existing Profiles project from the Git repository in RudderStack app.

  •   2 minute read  

You can import a Profiles project created using the Profile Builder (PB) tool and stored in a Git repo to:

  • View the project, its details, and the output tables in the UI.
  • Schedule the Profiles project to run at the specified frequency and time interval.
  • Seamlessly collaborate with your teammates, with modular control over your model files.

Prerequisites

  • Profiles project in a Git repository.
info
RudderStack recommends using a different target schema and user for Profiles for RudderStack app than the one used for CLI project. This will maintain differentiation in case of manual runs (using CLI) and scheduled runs (using RudderStack app):
New personal access token in RudderStack app

Steps

To import the Profiles project from a Git repository into the RudderStack platform:

  1. Log in to the RudderStack app and go to Unify > Profiles from the left sidebar.
  2. Click Create project.
Choose predefined template
  1. Select Import project from Git Repo on the next screen.
  2. Enter a name and description for your Profiles project.
  3. Enter the SSH URL of your Git repository to be used for your Profiles project:
warning
You cannot edit this Git repository URL later.


warning

Note that:

  • The SSH URL you provide must contain the Profiles project, otherwise it will cause an error.

  • The git SSH URL must match one of the below patterns:

    • git@<provider-host>:<org-name>/<repo-name>/tree/<branch-name>
    • git@<provider-host>:<org-name>/<repo-name>
    • git@<provider-host>:<org-name>/<repo-name>/tree/main/path/to/project
    • ssh://git@host:port/path.git

  • RudderStack supports any subfolder in the git project without the .git extension.

  • See the respective documentation for more information:

  1. Copy the SSH public key. Then, click Add deploy key which will take you to your git repository’s Deploy keys section. See Set up deploy keys for more information.
  1. Click Add deploy key. Then, add a Title, paste your SSH public key, and click Add key.
  2. Go back to the RudderStack app, then click Continue to let RudderStack verify read access.
  3. Select the warehouse and enter its credentials to store this Profiles project.
  1. Click Create Profiles project.

Then, you can choose any of the following options:

  • View Profiles project which takes you to the Overview tab of the project to view project details.
  • Run Profiles project which takes you to the History tab of the project from where you can click Run to run the project.

You can also explore other project settings in the different tabs.

warning
Once you import a git project, you cannot edit the Git repository URL.

Questions? Contact us by email or on Slack