Environment and Deployment Manager for Google App Engine Applications
Working towards this: http://12factor.net/config
This allows you to deploy the same code/application to multiple target environments (local, multiple different App Engine projects).
Critically, it also allows you to manage environment variables distinctly for each deployment target.
This tool uses appcfg.py to actually push the deployments out, but it builds a dynamic command, overriding the target application id and environment variables at deploy time.
Deployment targets and environments are configured in deploy.json, usually in your project root.
Here's a quick example where we have different database credentials for alpha and live environments.
{
"targets": {
"alpha": {
"app_id": "myapp-alpha",
"version": "alpha++",
"environment": {
"APP_DB_USER": "root",
"APP_DB_NAME": "DatabaseName",
"APP_DB_SOCKET": "/cloudsql/myapp:instance"
}
},
"live": {
"app_id": "myapp",
"version": "2",
"environment": {
"APP_DB_USER": "root",
"APP_DB_NAME": "LiveDatabaseName",
"APP_DB_SOCKET": "/cloudsql/myapp:instance"
}
},
}
}You can configure the environment variables for your local development server in your yaml files like this:
env_variables:
APP_DB_USER: root
APP_DB_NAME: localdbDeployment targets configured in deploy.json are executed using the deploy command, which is made available the vendor/bin folder by Composer.
For example, from your project root:
Deploy the examples module to the alpha target environment
vendor/bin/deploy run examples:alphaCreate a template deploy.json file
vendor/bin/deploy initShow the planned appcfg.py command for a deployment, but do not run it
vendor/bin/deploy test default:liveList the configured deployment targets
vendor/bin/deploy [verbose] targetsYou can use either app or default to deploy the default App Engine module (which is configured in your app.yaml file).
Each target is a different deployment, like "staging" and "production".
They must be uniquely named.
If you suffix your version name with ++ then we will auto-increment the version on each deployment.
In the example above, the first deployment gets alpha1 and the second alpha2 and so on.
In order to do this, we have to be able to detect what versions are already running. So, if you delete all your versions, we will start at 1 again.
You can "redirect" from your deploy.json file to another, usually intended for situations where your environment configurations are stored in another version control repository.
So, this might be your deploy file from your application folder:
{
"file":"../vendor/my-company/my-app-environment/deploy.json"
}In your composer.json require section:
"venditan/appengine-deploy": "v1.0.1"or with the command line
composer require venditan/appengine-deploy:v1.0.1