Skip to content

Latest commit

 

History

History
127 lines (82 loc) · 3.67 KB

README.md

File metadata and controls

127 lines (82 loc) · 3.67 KB
Raw

Docker Runtime for Meteor Apps

ImageLayers Size ImageLayers Layers Docker Pulls Docker Stars

Meteor Dockerized for Development and Production.

What is Meteor?

Meteor is an ultra-simple environment for building modern web applications.

With Meteor you write apps:

  • in pure JavaScript;
  • that send data over the wire, rather than HTML;
  • using your choice of popular open-source libraries.

Documentation is available at http://docs.meteor.com/.

What is this image?

When working with Meteor and Docker, there are two most common tasks that you will face:

  1. Local Meteor development with docker-compose;
  2. Building a production Docker image for your app.

This image is an attempt to solve both problems.

How to use this image?

Local development

When working with this image locally, all you need to do is to mount a folder with you source code to /app volume of the container.

Here is the docker-compose example:

meteor-app:
  image: codexsystems/meteor
  restart: unless-stopped
  links:
    - mongo
  volumes:
    - ./:/app
  ports:
    - 80:80
  environment:
    MONGO_URL: mongodb://mongo
    ROOT_URL: http://localhost

By doing this you will have you Meteor app listening on http://localhost:80 and hot code pushes working.

Building an image for your app

That's simple. Really. Just add the following Dockerfile into the root of your app:

FROM codexsystems/meteor

Then you can build the docker image with:

docker build -t yourname/app .

Then run it:

docker run -d \
    --link mongo \
    -e ROOT_URL=http://localhost \
    -e MONGO_URL=mongodb://mongo \
    -p 80:80 \
    yourname/app

And access it via http://localhost:80.

Running existing Meteor bundle

In case if you already have a Meteor bundle created for you app (for example with some CI service), you can use it instead of building a new bundle from the source code.

All you need to do in such case is to have your bundle directory or your bundle.tar.gz file in the project document root during Docker image build process.

Configuration

This image supports the same environment variables, as Meteor does.

However, there are also few additional environment variables supported that are used for better image usability:

  • METEOR_SETTINGS_FILE - In the Local development mode, this image will try to locate your settings.json file and attach it to the Meteor. You can use this environment variable if your settings file is named somehow else. Default value: settings.json.

Report

License

This image is released under the MIT License. See the bundled LICENSE.md for details.

Resources