Skip to main content

Create an XM Cloud project from existing source code in the XM Cloud Deploy App


How to create an XM Cloud project in the XM Cloud Deploy App using existing code or a starter template.

In the XM Cloud Deploy App, you can create projects and environments and set up deployment rules for the environment using a graphical user interface.

To create a new project, you must have an administrator or owner role in an XM Cloud organization, and you must host your existing source code on a version control platform supported by the XM Cloud Deploy App.

When you create a project, you also create an environment and run an initial deployment to the environment.

When creating a new XM Cloud project, you can perform the initial deployment using your existing source code.

To create a project from existing source code:

  1. Log in to your XM Cloud Deploy App account. If you are an admin in multiple organizations, click the organization you want to create a project for.

  2. On the Home page:

    • If your organization has not created any projects before, click Start from your existing XM Cloud code, and then click Next.

    • If your organization has already created a project, click Create new project, Start from your existing XM Cloud code, and then click Next.

  3. Click the source control provider and click Next.

  4. If you have not previously established a connection with your source control provider, click Create a new GitHub connection and follow your provider's instructions.

    Alternatively, to use an existing provider connection, in the Select an existing GitHub connection drop-down menu, click or enter the connection you want to use, then click Next.

  5. In the Project name field, enter the name you want for your project.

  6. In the Repository name field, enter a repository name to filter the list of your repositories and click the repository that contains your existing code, then click Next.

  7. In the Initial environment details dialog, in the Environment name field, enter the environment name, and in the Production environment field, choose whether the environment is a production environment.

  8. Optionally, in the Linked branch (optional) field, click a branch to link to the environment, and then, in the Trigger deployment on commit to branch drop-down menu, choose whether you want to trigger an automatic deployment when you push to the linked repository branch.

  9. Click Create and deploy.

The deployment process then:

  • Provisions the infrastructure and SaaS tenants to host the CM instance in the environment that you defined.

  • Pulls the existing XM Cloud compatible source code from the GitHub repository to a hosted XM Cloud build server and builds the solution.

  • Deploys the XM Cloud build artifacts on the provisioned CM instance.