Skip to main content
Version: 3.9.0

Manage Environments

This page describes actions that can be performed to an already created environment. If no environments are created yet, navigate to the Add Environment page:

Environments page

  • Environment status - displays the environment status. Can be red or green depending on if the KubeRocketCI portal managed to connect to the Git Server with the specified credentials or not.

  • Environment name (clickable) - displays the Git Server name set during the Git Server creation.

  • Open documentation - opens the documentation that leads to this page.

  • Enable filtering - enables filtering by Git Server name and namespace where this environment is located in.

  • Create new environment - displays the Create new component menu.

  • Edit environment - edit the environment by selecting the options icon next to its name in the environment list, and then selecting Edit. For details see the Edit Existing Environment section.

  • Delete environment - remove environment by clicking the vertical ellipsis button and then selecting Delete.

    note

    Please keep in mind that after deleting the environment, all the created resources within the environment will be deleted.

View Environment Details​

To view environment details, click the environment name in the environments list. Once clicked, the following data will be displayed:

Environment details

  • Filters - enables filtering by stage name, stage applications and stage health status.
  • Open environment in Argo CD - opens the corresponding resource in Argo CD.
  • Edit environment - allows to edit some parameters of the environment.
  • Delete environment - allows to remove the environment.
  • Create new stage - displays the Create stage menu.
  • Stage name (clickable) - opens the stage details page.
  • Stage status - displays the status of the created stage.
  • Create new stage - displays the Create stage menu.
  • Application name (clickable) - opens the details of the application that is deployed within the stage.
  • Application deployment status - displays the deployed application.
  • Open application logs - opens the the application container logs.
  • Open application terminal - opens the container terminal window.
  • Open application resource in Argo CD - opens a new tab with Argo CD resources related to the application.
  • Open stage in Argo CD / Grafana / Kibana - allows to view the stage in Argo CD, Grafana or Kibana.

Edit Existing Environment​

Edit the environment directly from the environment overview page or when viewing the environment data:

  1. Select Edit in the options icon menu next to the environment name:

    Edit environment when viewing the environment data

  2. Apply the necessary changes (edit the list of applications for deploy, application branches, and promotion in the pipeline). Add new extra stages by clicking the plus sign icon and filling in the application branch and promotion in the pipeline.

    Edit environment dialog

  3. Click the Apply button to confirm the changes.

Add a New Stage​

In order to create a new stage for the existing environment, follow the steps below:

  1. Navigate to the Stages block by clicking the environment name link in the environments list.

  2. Click the Create stage button:

    Add environment stage

  3. Fill in the required fields in the dialog. Alternatively, click Edit YAML in the upper-right corner of the Create stage dialog to open the YAML editor and add a stage. Please see the Stages Menu section for details.

  4. Click the Apply button.

Edit Stage​

In order to edit a stage for the existing environment, follow the steps below:

  1. Navigate to the Stages block by clicking the environment name link in the environments list.

    Edit environment stage

  2. Select the options icon related to the necessary stage and then select Edit.

    Edit environment stage dialog

  3. In the Edit Stage dialog, change the stage trigger type. See more about this field in the Stages Menu section.

  4. Click the Apply button.

Delete Stage​

warning

You cannot remove the last stage, as the environment does not exist without at least one.

In order to delete a stage for the existing environment, follow the steps below:

  1. Navigate to the Stages block by clicking the environment name link in the environments list.

  2. Click the name of the stage that needs to be deleted:

    Delete environment stage

  3. Click the recycle bin button to open the stage deletion menu:

    Delete environment stage

View Stage Data​

To view the environment stage data for the existing environment, follow the steps below:

  1. Navigate to the Stages block by clicking the environment name link in the environments list.

    Expand environment stage

  2. Click stage name. The following blocks will be displayed:

    Environment stage overview

    a. Overview - general information and configuration of current environment.

    b. Applications - displays the status of the applications related to the stage and allows deploying the applications. Applications health and sync statuses are returned from the Argo CD tool.

    c. Pipelines - displays all the deploy pipeline runs launched for this stage.

    d. Monitoring - opens the Grafana window that allows for watching various metrics.

Deploy Application​

To deploy an application, follow the steps below:

Deploy the promoted application

  1. Navigate to the Applications block of the stage and select an application.

    a. Select the image stream version from the drop-down list.

    b. (Optional) Enable setting custom values for Helm Charts. For more details, please refer to the Manage GitOps page.

    c. Click Start Deploy. Starts pipeline with deploy script.

    info

    In case of using OpenShift internal registry, if the deployment fails with the ImagePullBackOff error, delete the pod that was created for this application.

To uninstall the application, click the Delete button:

Uninstall the application

As a result, the application will be uninstalled in the Argo CD tool as well.

Troubleshoot Application​

There is a couple of KubeRocketCI portal capabilities that will help in monitoring and troubleshooting deployed applications, namely, terminal and logs.

To inspect the deployed application in KubeRocketCI portal, take the following steps:

  1. Open the application logs by clicking the Show Logs button:

    Show Logs button

  2. Inspect the shown logs:

    Inspect Logs

  3. Open the application terminal by clicking the Show Terminal button:

    Show Terminal button

  4. Operate the terminal to fix the problem if any:

    Inspect application