Code workflows with Cloud Platform

Code workflows with Cloud Platform

Frequently asked questions

Deploying code in the same environment

You can deploy a different branch or tag in the same environment from either the Environments page, or from the Environments overview page.

Deploying code from the Environments page

To switch the code deployed in an environment from one tag or branch to another:

1. In the Code element for the environment, click the code switch button.

   
2. In the Switch code dialog box, select a tag or branch from the Select branch menu and click Continue. In the Switch code confirmation dialog box, click Switch.

When you select a new branch or tag to deploy, Cloud Platform retrieves code from your repository and deployed to the appropriate environment on the infrastructure. The deploy task appears in the Activity task list.

Deploying code from the Environment Overview page

You can deploy code on an environment or copy code from one environment to another using the Overview page of the environment.

To switch the code deployed in an environment from one tag or branch to another:

1. On the Environments page, select an environment to view the corresponding Overview page.

2. In the Code section, click Switch.

   
3. In the Switch code dialog box, select a tag or branch from the Select branch menu and click Continue.

4. In the Switch code confirmation dialog box, click Switch.

   Important

   Symlinking your docroot directory to any other directory will cause code deployments to fail.

Moving code from one environment to another

To move code from one environment to another, such as Dev to Stage or from Stage to Prod, use one of the following processes, depending on your location in the Cloud Platform interface:

• From the Environments page

  1. Drag a Code element from one environment to another environment. Cloud Platform creates a new tag for the head version of the branch (the most recently committed code version) and then deploys the tag in the environment you selected. For example, drag your Dev Code element to Stage.

     

     Alternatively, you can add a commit message.

  2. Click Deploy.

  When you drag your Dev code container to the Stage environment, Cloud Platform creates a symbolic link between the Staging environment and the head version (the most recently committed code version) of trunk in your Development environment. When you click Deploy, Cloud Platform creates a tag and updates the infrastructure to that version of your code. The default tag format is yyyy‐mm‐dd.version (for example, tags/2016‐09‐18). From the example, the next tag you create would be 2016‐09‐18.0.

  When you have a version ready to deploy to your live production application, drag your code element from the Stage environment to Prod. If the Staging environment is running a tag, that same tag is deployed into Production.

• From the Overview page of an environment

  To copy code from one environment to another (creating and deploying a new tag) using the Overview page:

  1. On the Environments page, click the name of the environment to open that environment’s Overview page.
  2. On the Overview page for the environment, click Deploy.

  3. In the Deploy code dialog box, select the environment from which you want to copy a tag or branch, and click Continue.

     
  4. In the Deploy code confirmation dialog box, enter a commit message describing the new deployment, and click Deploy.

Reverting code

To revert code to an earlier version:

1. In the Code element for the environment, click the code switch button.
2. In the Switch code dialog box, select the tag for the version to which you want to revert, and then click Continue.
3. In the Switch code confirmation dialog box, click Switch.

When you deploy a previous branch or tag, Cloud Platform retrieves the code snapshot from your repository and then deploys it on the appropriate environment on the infrastructure.

Related topics

• Using your code repository
• Using the Live Development mode

Deploying code in the same environment

You can deploy a different branch or tag in the same environment from either the Environments page, or from the Environments overview page.

Deploying code from the Environments page

To switch the code deployed in an environment from one tag or branch to another:

1. In the Code element for the environment, click the code switch button.

   
2. In the Switch code dialog box, select a tag or branch from the Select branch menu and click Continue. In the Switch code confirmation dialog box, click Switch.

When you select a new branch or tag to deploy, Cloud Platform retrieves code from your repository and deployed to the appropriate environment on the infrastructure. The deploy task appears in the Activity task list.

Deploying code from the Environment Overview page

You can deploy code on an environment or copy code from one environment to another using the Overview page of the environment.

To switch the code deployed in an environment from one tag or branch to another:

1. On the Environments page, select an environment to view the corresponding Overview page.

2. In the Code section, click Switch.

   
3. In the Switch code dialog box, select a tag or branch from the Select branch menu and click Continue.

4. In the Switch code confirmation dialog box, click Switch.

   Important

   Symlinking your docroot directory to any other directory will cause code deployments to fail.

Moving code from one environment to another

To move code from one environment to another, such as Dev to Stage or from Stage to Prod, use one of the following processes, depending on your location in the Cloud Platform interface:

• From the Environments page

  1. Drag a Code element from one environment to another environment. Cloud Platform creates a new tag for the head version of the branch (the most recently committed code version) and then deploys the tag in the environment you selected. For example, drag your Dev Code element to Stage.

     

     Alternatively, you can add a commit message.

  2. Click Deploy.

  When you drag your Dev code container to the Stage environment, Cloud Platform creates a symbolic link between the Staging environment and the head version (the most recently committed code version) of trunk in your Development environment. When you click Deploy, Cloud Platform creates a tag and updates the infrastructure to that version of your code. The default tag format is yyyy‐mm‐dd.version (for example, tags/2016‐09‐18). From the example, the next tag you create would be 2016‐09‐18.0.

  When you have a version ready to deploy to your live production application, drag your code element from the Stage environment to Prod. If the Staging environment is running a tag, that same tag is deployed into Production.

• From the Overview page of an environment

  To copy code from one environment to another (creating and deploying a new tag) using the Overview page:

  1. On the Environments page, click the name of the environment to open that environment’s Overview page.
  2. On the Overview page for the environment, click Deploy.

  3. In the Deploy code dialog box, select the environment from which you want to copy a tag or branch, and click Continue.

     
  4. In the Deploy code confirmation dialog box, enter a commit message describing the new deployment, and click Deploy.

Reverting code

To revert code to an earlier version:

1. In the Code element for the environment, click the code switch button.
2. In the Switch code dialog box, select the tag for the version to which you want to revert, and then click Continue.
3. In the Switch code confirmation dialog box, click Switch.

When you deploy a previous branch or tag, Cloud Platform retrieves the code snapshot from your repository and then deploys it on the appropriate environment on the infrastructure.

Related topics

• Using your code repository
• Using the Live Development mode

Frequently asked questions