Editing a repository devfile for a Dev Environment
Use the following procedure to edit a repository devfile for a Dev Environment.
Editing a repository devfile for a Dev Environment in CodeCatalyst
To edit the repository devfile
Open the CodeCatalyst console at https://codecatalyst.aws/
. -
Navigate to the project that contains the source repository for which you want to edit the devfile.
-
In the navigation pane, choose Code.
-
Choose Source Repositories.
-
Choose the source repository that contains the devfile that you want to edit.
-
From the list of files, choose the
devfile.yaml
file. -
Choose Edit.
-
Edit the devfile.
-
Choose Commit, or create a pull request so a team member can review and approve the changes.
Note
If you edit your devfile, you have to restart the devfile for the changes to take effect. This can be done by running
/aws/mde/mde start --location devfile.yaml
. If there's a problem starting your devfile, it will enter
recovery mode. However, if you edit a devfile associated to a VPC-connected Dev Environment, you have to restart the Dev Environment
instead for the changes to take effect.
You can review which devfile is being used by running /aws/mde/mde status
. The location field has
the path of the devfile relative to the environment’s /projects
folder.
{
"status": "STABLE",
"location": "devfile.yaml"
}
You can also move the default devfile in /projects/devfile.yaml
to your source code repository. To update the
location of the devfile, use following command:
/aws/mde/mde start --location
.repository-name
/devfile.yaml
Editing a repository devfile for a Dev Environment in an IDE
To change the configuration of a Dev Environment, you must edit the devfile. We recommend that you edit the devfile in a supported IDE and then update your Dev Environment, but you can also edit the devfile from the root of the source repository in CodeCatalyst. If you edit the devfile in a supported IDE, you must commit and push your changes to the source repository or create a pull request so a team member can review and approve the devfile edits.