Clone a Project

Sometimes, you may need to clone a project. For example, you may need to clone a development project to use in production or clone a production project for testing purposes.

To clone a project, you can use the following methods:

  • Gray pages
  • API
  • Ruby SDK

Contents:

Objects Included in and Excluded from Cloning

When a project is cloned, the following objects are excluded from the export and are not cloned:

  • ETL processes (including both CloudConnect graphs and Ruby scripts)
  • ETL graphs
  • Schedules
  • Notifications

The objects that are cloned include, among others, metrics, reports, email schedules with their recipients, and so on. If you want some objects not to be in the newly cloned project, you need to remove them manually after the cloning process is completed. Alternatively, you can perform a partial export and import using API (see API: Export Part of a Project and API: Import Part of a Project) or the gray pages where you can choose to include or exclude specific data.

Project Database Limitations

Depending on what database your projects runs on, you can clone:

  • A project running on PostgreSQL to another PostgreSQL project
  • A project running on PostgreSQL to a project running on Vertica
  • A project running on Vertica to another Vertica project

You cannot clone a project running on Vertica to a project running on PostgreSQL. However, you can perform a partial export of reports or dashboards from Vertica to PostgreSQL.

Clone a Project via Gray Pages

To clone a project via the gray pages, complete the following steps:

  1. Export the project that you want to clone.
  2. Create a new project.
  3. Import the generated export to the newly created project.

Export the Project to Clone

This procedure assumes that you access your projects at https://secure.gooddata.com/.

If you are a white-labeled customer, replace secure.gooddata.com with your white-labeled domain in the procedure steps when needed.

Steps:

  1. Go to the gray page for project maintenance:

    https://secure.gooddata.com/gdc/md/{project-id}/maintenance

    where {project-id} is the ID of the project that you want to clone.

  2. Click export.
    The project export page opens.
  3. Depending on your requirements, select some or all export options to apply to the project clone.
  4. (Optional) In the Authorized users field, add users who would be authorized to manage the generated export and import it into a new project. Separate individual users with a line break. Adding authorized users helps when you are cloning a project between two domains. As a user exporting the project, you are authorized by default.
  5. Click submit.
    The export process starts.
    When the export is generated, the response similar to the following is displayed:
  6. Copy the value of the token keyword and save it for later. You are going to use it when importing the generated export to a new project.

After the export has been generated, you have approximately 24 hours to import the generated export into a new project.

Create a New Project

For information, see Create a Project.

When the new project is created, obtain its ID and save it for later. For more information, see Find the Project ID.

Import the Generated Export to the Newly Created Project

After the export has been generated, you have approximately 24 hours to import the export into a new project.

This procedure assumes that you access your projects at https://secure.gooddata.com/.

If you are a white-labeled customer, replace secure.gooddata.com with your white-labeled domain in the procedure steps when needed.

Steps:

  1. Go to the gray page for project maintenance:

    https://secure.gooddata.com/gdc/md/{project-id}/maintenance

    where {project-id} is the ID of the newly created project.

  2. Click import.
    The project import page opens.

  3. In the Import token field, paste or enter the value of the token that was generated during the export.
  4. Click submit.
    The import process starts. Depending on the size of the imported project, this process may take a while.
    When the import completes, the following response is displayed:

  5. Log in to the GoodData Portal, and verify that the content of the source project is available in the newly created project.

Clone a Project via API

This method is typically used for creating multiple clones of a single source project. Cloned projects include users and project data from the source project.

To clone a project via the API, complete the following steps:

  1. Export the project that you want to clone. See API: Export a complete project.
  2. Create a new project. See API: Create a project.
  3. Import the generated export to the newly created project. See API: Import a complete project.

Clone a Project via Ruby SDK

See the following examples of cloning projects:

Also, see how to work with a project interactively.