Documentation
Feedback
Guides
Troubleshooting

Troubleshooting
Development
I am getting errors with my service configuration app

Errors with the service configuration app occur depending on your workspace configuration

If you are developing a configuration app, you may be getting errors because the service your app is configuring is installed or linked to a different workspace. This happens because, when creating a new configuration app, the configuration builder first looks for that configuration schema in all the apps installed in your current workspace. Consequently, linking your app may fail if the configuration builder cannot find this specific configuration.

Solution

Below, we outline solutions for addressing errors with your service configuration app:

  1. Avoid errors when installing or linking your configuration app.
  2. Publish your configuration app in an alternative workspace.

Avoiding errors when installing or linking your configuration app

To avoid errors, link or install the configuration app in the same workspace the service app is linked or installed. Follow the instructions below:

  1. In a terminal, go to the desired workspace using the following VTEX IO CLI command:


    _10
    vtex use workspace {desiredWorkspace}

    Replace {desiredWorkspace} with the workspace you want to work in.

  2. If your service app is not yet linked or installed, link or install your service app.

  3. Link or install your configuration app.

Publishing your configuration app in an alternative workspace

To publish your configuration app without installing the service in the master workspace, follow the instructions below:

  1. In a terminal, go to the desired workspace using the following VTEX IO CLI command:


    _10
    vtex use workspace {desiredWorkspace}

    Replace {desiredWorkspace} with the workspace you want to work in.

  2. If your service app is not yet linked or installed, link or install your service app.

  3. Create a new version of your configuration app by following the instructions in Releasing a new app version.

  4. Publish your configuration app using the following command:


    _10
    vtex publish -w {desiredWorkspace}

    The -w flag allows you to choose the workspace of the app you are publishing.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page