How to create, initialize, and delete a Platform.sh project from the command line

Goal

To fully manage the life cycle of sites on Platform.sh, including the creation of new projects, initializing from a hosted GitHub repository, and deleting projects.

Assumptions

Problems

You will need a public GitHub project that already has the required YAML files to work with Platform.sh.

Steps

1. Creating projects

To create a new project, use the platform create command.

2019-04-03_09-50-13%20(1)

2. Initializing projects from a GitHub repository

The platform environment:init command requires both the Project ID of the newly created project and the URL of the GitHub project. Note that as of version 3.40.8 of the Platform.sh CLI, the environment:init command is considered beta and not listed via platform list.

platform environment:init -p <Project ID> -e master <GitHub URL>

2019-04-03_10-33-32%20(1)

Open the new site in your browser with the following command:

platform url -p <Project ID>


platform url -p ov4iu6fcb35jg

Environment ID [master]:

Enter a number to open a URL

[0] https://master-7rqtwti-ov4iu6fcb35jg.de-2.platformsh.site/

[1] https://www.master-7rqtwti-ov4iu6fcb35jg.de-2.platformsh.site/

[2] http://master-7rqtwti-ov4iu6fcb35jg.de-2.platformsh.site/

[3] http://www.master-7rqtwti-ov4iu6fcb35jg.de-2.platformsh.site/

> 0

https://master-7rqtwti-ov4iu6fcb35jg.de-2.platformsh.site/

15

3. Deleting projects

Delete the project with the following command:

platform project:delete -p <Project ID>

You will be prompted to type the name of the project as a security confirmation, since deleting a project is irreversible.


platform project:delete -p ov4iu6fcb35jg

You are about to delete the project:

New Drupal Site (ov4iu6fcb35jg)

* This action is irreversible.

* Your site will no longer be accessible.

* All data associated with this project will be deleted, including backups.

* You will be charged at the end of the month for any remaining project costs.

Are you sure you want to delete this project? [y/N] y

Type the project title to confirm: New Drupal Site

Conclusion

The Platform.sh CLI enables full life cycle management of your sites. It is not even necessary to use Git directly when creating, initializing, and deleting sites.