Skip to main content

Updating CityLens

Updating CityLens Routes UI​

  1. Fetch new installation artifacts.

    1. In the DGCLI configuration file, specify:

      • New version of the citylens component (see CityLens releases).
      • Versions of core, api-platform, and pro components required to install the new CityLens version (see the Dependencies subsection in the CityLens releases description).

    2. Run the fetch command.

      For more settings, see DGCLI command-line arguments.

  2. Copy the path to a new manifest file from the command output and set it as a value to the dgctlStorage.manifest parameter in the values-citylens-ui.yaml configuration file. For more information, see the installation guide.

    Important

    If during a regular update of the CityLens service you do not want to import new data, use the same manifest as in the previous import. In other cases, using a new manifest is recommended.

  3. Check out breaking changes. If necessary, update other settings in the values-citylens-ui.yaml configuration file.

  4. Run the command to update the service:

    helm upgrade --version=VERSION --atomic --values ./values-citylens-ui.yaml citylens 2gis-on-premise/citylens

    In the --version parameter, set the new citylens component version that you specified in the DGCLI configuration file.

  5. Test if the update succeeded.

Updating CityLens API and CityLens Routes API​

  1. Fetch new installation artifacts.

    1. In the DGCLI configuration file, specify:

      • New version of the citylens component (see CityLens releases).
      • Versions of core, api-platform, and pro components required to install the new CityLens version (see the Dependencies subsection in the CityLens releases description).

    2. Run the fetch command. Additionally you can specify the following flags:

      • To update only the service image, add the --only-apps flag after the pull command.
      • To update only data, add the --only-data flag after the pull command.
      • To update both service and data, run the command without the above flags.

      For more settings, see DGCLI command-line arguments.

  2. Copy the path to a new manifest file from the command output and set it as a value to the dgctlStorage.manifest parameter in the values-citylens-api.yaml configuration file. For more information, see the installation guide.

    Important

    If during a regular update of the CityLens service you do not want to import new data, use the same manifest as in the previous import. In other cases, using a new manifest is recommended.

  3. Check out breaking changes. If necessary, update other settings in the values-citylens-api.yaml configuration file.

  4. Run the command to update the service:

    helm upgrade --version=VERSION --atomic --values ./values-citylens-api.yaml citylens 2gis-on-premise/citylens

    In the --version parameter, set the citylens component version:

    • To update only the service or both service and data, use the new version that you specified in the DGCLI configuration file.
    • To update only data, set the currently installed version.

  5. Test if the update succeeded.