Changelog
1.5.1 - June 2, 2020
Changelog
1.5.0 - June 1, 2020
Upgrading notes
mup
. If you are using an older version, it will tell you and exit. This does not affect what versions of Meteor mup supports (Meteor 1.2 and newer)mup setup
and mup reconfig
after upgradingLoad Balancing and Zero Downtime Deploys
There are two different implementations for load balancing. This is the simpler one. The other one is mentioned under the Swarm
section.
Mup is now able to use Nginx to load balance across multiple servers with sticky sessions. When this is used with at least two servers, there will be zero downtime during deploys.
How it works:
privateIp
option is configured for each server). In the future mup might setup a firewall to restrict access to the servers with nginx.mup setup
or mup proxy setup
is run, a Nginx config is generated with a list of the server's private IP's, or, if that isn't available, their host
.Sticky sessions can be disabled for apps that do not need it.
Private Docker Registry
Mup can be configured to use a private docker registry, which allows it to deploy to multiple servers much faster. Instead of uploading the bundle and running Prepare Bundle task on every server, it can do that one a single server, store the image in the registry, and use that image on all of the other servers.
Production Debugging of Meteor Server
Run mup meteor debug
to debug your Meteor app in production. It will enable debugging in your app and forward the port to your computer so you can use Chrome's DevTools for Node, Visual Studio Code, or another debugger for node. Requires Meteor 1.6 or newer.
Swarm
Meteor Up can now manage a docker swarm cluster. When swarm is enabled in the config, Meteor up sets up a swarm cluster on all of the servers listed in the config. During mup setup
, it diffs the config given to it by plugins and the mup config with the current cluster state and carefully makes any needed adjustments to avoid unnecessarily disrupting running swarm services. Mup uses Docker Swarm instead of Kubernetes since it is simpler and uses fewer resources.
When using swarm, rolling deploys and load balancing are always enabled. This uses a different implementation than when load balancing without Docker Swarm without the downsides it has.
We have tried to make using swarm with Meteor Up as simple and reliable as possible. In the rare situation there is an error and you have to take manual action to resolve, in many cases mup gives a solution with the error.
proxy.servers
option has been added to list which servers to run the reverse proxy on. It is required when using docker swarmmup docker status
shows a warning when the servers do not have the same docker version (@rolljee)1
, 2
, 3
) instead of previous
and current
. This is needed for swarm to correctly roll back failed deploys, but it will also give us more control over how many old versions to keep and allow manually rolling backPerformance
app.docker.useBuildKit
option. When enabled, it uses the new docker image builder which reduces time spent by Prepare Bundle by 60%mup mongo start
only starts/restarts the container if it isn't running or the start script has changed. This can greatly speed up mup setup
since starting MongoDB was one of the slower tasksMUP_SKIP_UPDATE_CHECK=false
opencollective
with opencollective-postinstall
for smaller message and fewer dependencies (@rolljee)Other Features
--overview
option to mup status
. It only shows the top-level status for each plugin and any problemsmongo.dbName
option. Multiple apps can share a database by setting it to the same value in all of their configsmup meteor destroy
command to stop and remove app from the serversproxy.servers
option to specify which servers to run the reverse proxy onmup ssh
now respects the --servers
optionVerifying Deployment
app.deployCheckWaitTime
Reduce common problems
http
to https
in the ROOT_URL
environment variable when using the reverse proxy and SSL (@rolljee)app.docker.imagePort
defaults to 3000 instead of 80. This change is backwards compatible with the common docker images, and simplifies using images that run the app with a non-root userapp.servers
is emptyDocs
Bugs Fixed
NODE_VERSION
build arg is set when building the image during Prepare Bundle with the correct node version for the Meteor version the app is using. This fixes using the zodern/meteor
image with newer versions of Meteor.mup reconfig
not able to remove environment variables that were set during the last deployVIRTUAL_PORT
environment variable is now set to the same value as app.docker.imagePort
$
were removed by bash)remoteCommand
hooksmeteor status
when docker logs warningsPlugin API
tasks
has functions that can add reusable tasks to task lists. The functions are:
addCreateService
addUpdateService
addCreateOrUpdateService
runSSHCommand
can also accept a session instead of a server object. It is recommended to use sessions since mup now reuses themrunSSHCommand
will now also include stderrvalidateConfig
has an additional parameter logProblems
to enable showing validation errorsvalidationErrors
has errors even when getConfig(false)
was usedVALIDATE_OPTIONS
has noDefaults: true
setStatusDisplay
class to help with printing the status and deciding what to show when --overview
is used