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: 
ona 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: 
    ona automations update .gitpod/automations.yml
  2. Rebuild your environment with the new devcontainer.json: 
    ona 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 ona 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: