Skip to content
Last update: January 29, 2025

Enable GitOps

To ensure that your environments are always up to date with the latest configurations, enable GitOps.

For demonstration purposes, let's update the Platform from version 3.851 to 3.852:

Old version

Warning

When upgrading to a version significantly beyond the current one, it is recommended to first test it on a local machine to check module compatibility with the new version. If a module version is incompatible with the Platform, the system may show a Degraded status during the update. Refer to the Troubleshooting section to learn how to identify the causes of errors.

Set up Virto Cloud Portal

  1. Open the Virto Cloud Portal and select Environments in the main menu.
  2. In the next blade, click Api key in the toolbar. The generated API key opens in the next blade. Copy it to clipboard to use later.
  3. Select your environment.
  4. In the next blade, switch the GitOps option to on.
  5. Click Save in the toolbar.
  6. Click Download manifest.

Portal configuration

Set up GitHub

  1. Download the initial GitOps template for Virto Cloud as a ZIP archive (click Code, then Download ZIP):

    Download template

    It contains the minimal setup required for Virto Cloud and GitHub.

  2. Create a new repository to store your configuration. Go to your personal or organization account in GitHub, open the Repositories tab, then click New. Give it a descriptive name (vc-deploy-dental in our case).

  3. Clone the repository, open it locally.
  4. Unzip and copy the downloaded template structure into the cloned repository.
  5. Make the first commit and open the template. Adjust the files from the template to link it to your environment:

    Adjust files

  6. Commit and push changes to your repository.

Manage secrets

  1. In your repository, go to SettingsSecrets and variablesActionsNew repository secret.
  2. Add the secrets (VIRTOSTART_ACR_DOCKER_PASSWORD and VIRTOSTART_PLATFORM_TOKEN), that are required for the automation workflows to access Virto Cloud and deploy changes:

    Secrets

    Note

    The secrets can be edited. However, you will not see previously saved values when editing.

Run workflows

Let's check how the following workflows work:

Cloud infra deployment

  1. In your repository, go to Actions tab, then click Cloud infra deployment.
  2. By default, this action is triggered automatically when there’s a commit to the main branch. Alternatively, you can start it manually by clicking Run workflow:

    Manual run

  3. Monitor the update process:

    Portal update

The Synced and Healthy statuses indicate that the process is complete.

Cloud platform deployment

  1. In your repository, go to Actions tab, then click Cloud platform deployment.
  2. By default, this action is triggered automatically when there’s a commit to the main branch. Alternatively, you can start it manually by clicking Run workflow:

    Manual run

  3. Monitor the update process:

    Portal update

The Synced and Healthy statuses indicate that the process is complete.

The Platform version has been successfully updated:

Updated Platform version

Troubleshooting

If you encounter issues, such as a Degraded status, you can identify the cause as follows:

  1. Go to Environments → Your environment → ApplicationsPlatform
  2. Click Logs in the toolbar.
  3. The Platform logs open in the next blade. Find the degradation reason.
  4. If you need any assistance resolving the error, please contact our support team.