Skip to content

Automate Meteor deployments on Google Cloud App Engine Flexible

License

Notifications You must be signed in to change notification settings

edvisor-io/meteor-google-cloud

Repository files navigation

Meteor Google Cloud

Project Status: Active – The project has reached a stable, usable state and is being actively developed.

A command line tool for deploying Meteor applications on Google Cloud App Engine Flexible.

What is Google Cloud App Engine Flexible?

App Engine allows developers to focus on doing what they do best, writing code. Based on Google Compute Engine, the App Engine flexible environment automatically scales your app up and down while balancing the load.

Meteor needs to run on App Engine Flexible, not Standard.

App Engine manages your virtual machines, ensuring that:

  • Instances are health-checked, healed as necessary, and co-located with other services within the project. Critical, backwards compatible updates are automatically applied to the underlying operating system.
  • VM instances are automatically located by geographical region according to the settings in your project. Google's management services ensure that all of a project's VM instances are co-located for optimal performance.
  • VM instances are restarted on a weekly basis. During restarts Google's management services will apply any necessary operating system and security updates.
  • You always have root access to Compute Engine VM instances. SSH access to VM instances in the flexible environment is disabled by default. If you choose, you can enable root access to your app's VM instances.

For more information, check: App Engine Flexible Environment's page.

App Engine Flexible Pricing

Because we run Meteor on the Flexible environment you may not be able to use the free tier of App Engine Standard. For the first year you may have $300 in credit per month, but be aware of the costs:

Installation

npm install meteor-google-cloud -g

Deploying

To deploy to App Engine Flexible, follow the steps bellow:

1. Install gcloud CLI

Follow the guide on: https://cloud.google.com/sdk/install

2. Init Meteor Google Cloud

If this is the first time you deploy, you will need some specific files on your repo, run the command below to get them automatically generated.

meteor-google-cloud --init

3. Set your App Engine Flexible settings

cd ./deploy
ls
Dockerfile	app.yml		settings.json
  • Dockerfile: you can customize your Docker image, if you don't need to or don't know how to, you can either delete this fle or leave iit as is.
  • app.yml: The settings and preferences of your App Engine service goes in here, check Google's app.yml documentation for full options.
  • settings.json: This is your normal Meteor settings file, you will need to have the special key meteor-google-cloud for the deployment settings.
    • Required keys:
      • project: The project name of the project on Google Cloud to use.
    • Other keys: You can add any option you would like here, and they will be passed to gcloud deploy app command, for the full list, check Google's gcloud deploy documentation.

4. Deploy

meteor-google-cloud --settings deploy/settings.json --app deploy/app.yml --docker deploy/Dockerfile 

P.S: It may take a few minutes to build your app, which may appear to be unresponsive, but it's not, just wait.

CLI options

The Meteor Google Cloud CLI supports the following options:

  -v, --version             output the version number
  -i, --init                init necessary files on your repo
  -b, --build-only          build only, without deploying to gcp
  -s, --settings <path>     path to settings file (settings.json)
  -c, --app <path>          path to app.yaml config file
  -d, --docker <path>       path to Dockerfile file
  -p, --project <path>      path of the directory of your Meteor project
  -o, --output-dir <path>   path of the output directory of build files
  -v, --verbose             enable verbose mode
  -q, --quiet               enable quite mode
  -ci, --ci                 add --allow-superuser flag in meteor commands for running in CI
  -h, --help                output usage information
  --node-version <version>  set custom node version
  --npm-version <version>   set custom npm version

FAQ

1. Does App Engine supports websockets? Yes, announced in February 5, 2019, more info.

2. Does App Engine supports session affinity? Yes.

3. Do I get auto scaling? Yes.

4. Do I get auto healing? Yes.

5. Can I add the environment variables to the settings.json? Yes. Just create add a property env_variables to meteor-google-cloud. It will prefer those over the ones in your app.yaml.

Support

We welcome any questions, contributions or bug reports in the GitHub issue tracker.

Meteor Azure

This package was heavily inspired on meteor-azure, a deployment packge for Meteor applicatons on Microsoft Azure, click here for more information.

License

MIT