Troubleshooting DevKit

This troubleshooting guide is designed for developers working with the Private Compute Infrastructure DevKit, a tool intended for developing and managing applications within secure, privacy-preserving environments. If you have any implementation questions or feedback that is not shown on this troubleshooting guide, please contact us by filing an issue in our GitHub repository.

Guide topics:

Diagnose Setup Environment

Error Cause Resolution
Command devkit not found The required linux symlink to the hidden folder was not created. From the root of your GitHub repository, make sure that you have executed after completing the submodule command that creates the hidden directory named .devkit/.
  ln -s .devkit/devkit devkit
ERROR: The 'build' command is only supported from within a workspace (below a directory having a MODULE.bazel file). This happens when you are not building against a Bazel project and probably occurred by skipping the bootstrap step. From root, ensure that you are executing the bootstrap command before the build command. Add in your selected language template and toolchain.
  devkit/bootstrap --template cpp --args toolchain=llvm_bootstrapped
  devkit/build bazel build //...
Read more about Bazel.

Diagnose Gemini Environment

Error Cause Resolution
Access blocked: Authorization Error A few causes for this can be that there is caching that needs to be cleared and / or the expected shell variable GOOGLE_CLOUD_PROJECT was not set. Execute the following within your bash shell terminal, before re-executing devkit/gemini:
  • reset: Clears the cache and reset your terminal to default
  • GOOGLE_CLOUD_PROJECT: Variable that contains your existing Google Cloud Project name
Read more in our Gemini and DevKit guide.

Take note that the dev and gemini local containerized development environments are meant to be run separately and not built to be called within another environment.

Don't: Don't nest these script calls within each containerized environment.

  devkit/dev
  devkit/gemini

Do: The tool would be available within the containerized environment, as designed.

  devkit/dev
  gemini

Feedback

If you don't see a resolution to your DevKit issue, notify us by filing a GitHub issue.