Version:

Import Profiles Project from Git

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

  •   2 minute read  

If you have created a Profiles project using the Profile Builder (command-line tool), you can make it available in a Git repository, and further import it in the RudderStack dashboard to:

  • View the project, its details, and the output tables in the UI.
  • Schedule its invocation periodically (for example, every 12 hours, 6 hours, etc.).
  • 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 dashboard than the one used for CLI project. This will maintain differentiation in case of manual runs (using CLI) and scheduled runs (using RudderStack dashboard):

Steps

To import the Profiles project from a Git repository in the RudderStack dashboard:

  1. Log in to the RudderStack dashboard and go to Unify > Profiles option in the left sidebar.
  2. Click Create project.
Choose predefined template
  1. Select Import project from Git Repo on the next screen.
  2. Enter a unique 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 afterwards.


warning

Note that:

  • The SSH URL you provide must contain the Profiles project, otherwise it can result in an error.
  • The git SSH URL must follow any 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 GitHub documentation, GitLab documentation, and BitBucket 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 dashboard, then click Continue to let RudderStack verify read access.
  3. Select the warehouse and enter its credentials to store this Profiles project.
  1. Finally, click Create Profiles project.

Next, 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 explore other project settings in the different tabs. For more information, see Project details.

Questions? Contact us by email or on Slack