This repository is used with ddev get platformsh/ddev-platformsh
to get a rich integration between your checked-out Platform.sh project and DDEV.
- Make sure you have DDEV v1.21.1+ installed
- The following tools need to be installed for the add-on to run smoothly (you may get them using your regular package manager):
jq
base64
perl
- Clone your project repository (e.g.
platform get <projectid>
) cd
into your project directory- Run
ddev config
and answer the questions as appropriate - Run
ddev get platformsh/ddev-platformsh
and answer the questions as appropriate - Run
ddev start
- (Optional) Run
ddev pull platform
to retrieve a copy of the database and contents from the project's file mounts from the environment you entered in step #5- If you only want to retrieve the database (skipping the file mounts), add the
--skip-files
flag to theddev pull platform
command
- If you only want to retrieve the database (skipping the file mounts), add the
- If your local project has a different database type than the upstream (Platform.sh) database, it will conflict, so please back up your database with
ddev export-db
andddev delete -y
before starting the project with new config based on upstream. - Your experience is super-important: Please let us know about how it went for you in any of the DDEV support venues
- Takes your checked-out Platform.sh project and configures DDEV based on that information.
- PHP and Database version
- hooks are converted to DDEV post-start hooks
- A working
ddev pull platform
integration with all mounts is created. - Exposes specific
$PLATFORM_
variables (e.g.,$PLATFORM_RELATIONSHIPS
)
- Supports the following services:
- Databases
- MariaDB
- Oracle MySQL
- Postgresql
- Redis
- Memcached
- ElasticSearch
- Databases
These Platform.sh templates are included in the automated tests that run nightly. They will be growing in maturity with your feedback!
- Populate important PLATFORMSH environment variables that would be found upstream
- Populate PHP and other dependencies configured upstream
- Automatically figure out the name and other information of the upstream project
- Automatically configure the .ddev/providers/platform so you can immediately do a
ddev pull platform
with no configuration effort. - Let us know what's important to you!
Contributed and maintained by @rfay and @lolautruche