Chapter 2. Deploy the Cloud App

Depending on the setup of your cluster, the Cloud App may need to be deployed manually after creating the project.

  1. In the Apps, Cloud Apps & Services section of the screen, click on the Cloud App - this will display the App Details screen.

  2. In the App Details section of the screen, see the value of the Cloud App Status field.

    If the status is Stopped, you must deploy the Cloud App. If it is Running, skip to section 3. Preview the Client App.

    Cloud App Status

  3. Click Deploy on the sidebar on the left.

    Deploy Cloud App

  4. Click Deploy Cloud App

    Note

    By default, the Cloud App deployment reuses existing container images built from the same commit hash and for the same Node.JS runtime. To force RHMAP to create a new container image, select the Clean Stage option.

    Once the deployment is finished, the progress bar turns green and the Cloud App is deployed.

  5. Click Details on the sidebar on the left.
  6. Verify that the Cloud App Status is now Running.

2.1. Cloud App Deployments

Deploying a Cloud App into an Environment can require a Cloud App source-to-image (S2I) build that creates a new container image. RHMAP reuses the container image created in the previous Environment when reuse is appropriate, that is, when both the commit hashes and Node.JS runtime versions are identical. This provides more consistency and better performance for Cloud App deployments.

2.2. Build Queue Policy

When you deploy a Cloud App, RHMAP creates an asynchronous request to the OpenShift API and the Deploy Cloud App button is disabled until the build completes and the application is deployed. Only one running deployment and one queued deployment can exist at the same time, and if you deploy an additional Cloud App, it will replace the Cloud App currently in the queue. To deploy a Cloud App under these conditions, either wait for the existing deployment to complete, or cancel the existing deployment. This policy is described further in SerialLatestOnly Run Policy.

Note

Various build policies are described in the Build Run Policy including the SerialLatestOnly run policy. However, you cannot change this policy for RHMAP, that is, the SerialLatestOnly run policy applies for all RHMAP deployments.