Skip to main content
Ona uses Dev Containers and Tasks and Services as its core configuration elements. Migration involves converting your .gitpod.yml into a devcontainer.json and automations.yml setup.

​
Migrate the configuration

Create a new Ona environment for your existing repository and run the migration command: 
gitpod env migrate
This command generates two key files:
  • .devcontainer/devcontainer.json: Defines your development environment by setting the workspace folder, image, user, and other settings, aligned with Gitpod Classic experience.
  • .gitpod/automations.yml: Contains tasks extracted from .gitpod.yml, maintaining their dependency order.

​
Test the configuration

  1. Deploy the automations.yml file: 
    gitpod automations update .gitpod/automations.yml
  2. Rebuild your environment with the new devcontainer.json: 
    gitpod environment devcontainer rebuild
  3. The default workspace folder in Dev Container differs from Gitpod Classic (/workspaces vs /workspace). VS Code may not open the correct folder automatically after rebuilding. Use the “Open File” option in VS Code to select the /workspace/<project> folder.

​
Customize the configuration

While gitpod env migrate creates these baseline files, you need to make manual adjustments to match your requirements. The default Dev Container image differs from the Gitpod Classic workspace image. Create a custom image to match your previous setup. Refer to the following resources to learn more about the configuration options: