Zephyr Cloud Docs

    ZE10020: Failed to initialize Zephyr agent

    Could not initialize Zephyr Agent.

    • Error Code: ZE10020
    • Location: Terminal
    • Related plugins: Rollup

    On your build start, there are a list of actions we run through. If any of these actions failed, Zephyr agent will fail to initialize in the Rollup plugin.

    1. Understanding environment
    Git info, package.json's information.
    2. Application configuration

    Application configuration including your remote modules, build id and assets.

    Debugging the error

    Valid package.json file

    Package.json should be in json format, include name and version) sits in the same directory as your bundler configuration. A typical project structure Zephyr would understand would be similar to below set up, where each application has their unique name in package.json.

    HostAppDir:
  - package.json
      name: "host-app"
      version: "1.0.0"
  - webpack.config.js

RemoteAppDir:
  - package.json
      name: "remote-app"
     version: "1.0.0"
  - webpack.config.js

    Related error and potential resolution:

    Ensure git configuration

    Make sure you have git remote origin url, git username, email configured.

    Related error and potential resolution:

    Build tool configuration

    Your remote modules' configuration should be in a typical format Zephyr understands. For example:

    plugins = [
  new CopyRspackPlugin({
    patterns: [
      {
        from: './src/index.html',
        to: './index.html',
      },
    ],
  }),

  new ModuleFederationPluginV1({
    name: 'app_04',
    filename: 'remoteEntry.js',
    shared: [],
    exposes: {
      './App': './src/main.js',
      './loadApp': './src/loadApp.js',
    },
  }),
];

    Remove your local configuration file

    Remove ~/.zephyr by running below commands and login from either dashboard or sidepanel on Chrome again.

    rm -rf ~/.zephyr