app ⇒ App

The class to instantiate a new App

Since: 3.0.0

Returns: App - An App instance

• app ⇒ App
  • .config
  • .events
  • .info
  • .root
  • .tasks
  • .destroy() ⇒ Promise
  • .init() ⇒ Promise
  • .rebuild() ⇒ Promise
  • .restart(app) ⇒ Promise
  • .start() ⇒ Promise
  • .stop() ⇒ Promise
  • .uninstall(purge) ⇒ Promise

app.config

The apps configuration

Since: 3.0.0

app.events

The apps event emitter

Since: 3.0.0

app.info

Information about this app

Since: 3.0.0

app.root

The apps root directory

Since: 3.0.0

app.tasks

Tasks and commands the app can run

Since: 3.0.0

app.destroy() ⇒ Promise

Hard removes all app services, volumes, networks, etc.

This differs from uninstall in that uninstall will only soft remove all app services, while maintaining things like volumes, networks, etc.

That said this DOES call both stop and uninstall under the hood.

Emits: pre_destroy, pre_stop, post_stop, pre_uninstall, post_uninstall, post_destroy
Since: 3.0.0
Returns: Promise - A Promise

app.init() ⇒ Promise

Initializes the app

You will want to run this to get the app ready for lando.engine. This will load in relevant app plugins, build the docker compose files and get them ready to go

Emits: pre_init, post_init, ready
Since: 3.0.0
Returns: Promise - A Promise.

app.rebuild() ⇒ Promise

Rebuilds an app.

This will stop an app, soft remove its services, rebuild those services and then, finally, start the app back up again. This is useful for developers who might want to tweak Dockerfiles or compose yamls.

Emits: pre_stop, post_stop, pre_rebuild, pre_uninstall, post_uninstall, post_rebuild, pre_start, post_start
Since: 3.0.0
Returns: Promise - A Promise.

app.restart(app) ⇒ Promise

Stops and then starts an app.

This just runs app.stop and app.start in succession.

Emits: pre_stop, post_stop, pre_start, post_start
Since: 3.0.0

Returns: Promise - A Promise.

app.start() ⇒ Promise

Starts an app.

This will start up all services/containers that have been defined for this app.

Emits: pre_start, post_start
Since: 3.0.0
Returns: Promise - A Promise.

app.stop() ⇒ Promise

Stops an app.

This will stop all services/containers that have been defined for this app.

Emits: pre_stop, post_stop
Since: 3.0.0
Returns: Promise - A Promise.

app.uninstall(purge) ⇒ Promise

Soft removes the apps services but maintains persistent data like app volumes.

This differs from destroy in that destroy will hard remove all app services, volumes, networks, etc as well as remove the app from the appRegistry.

Emits: pre_uninstall, post_uninstall
Since: 3.0.0

Returns: Promise - A Promise.

"pre_destroy"

Event that runs before an app is destroyed.

Since: 3.0.0

"post_destroy"

Event that runs after an app is destroyed.

Since: 3.0.0

"pre_init"

Event that allows altering of the app object right before it is initialized.

Note that this is a global event so it is invoked with lando.events.on not app.events.on See example below:

Since: 3.0.0
Properties

"post_init"

Event that allows altering of the app object right after it has been full initialized and all its plugins have been loaded.

Since: 3.0.0
Properties

"ready"

Event that runs when the app is ready for action

Since: 3.0.0
Properties

"pre_rebuild"

Event that runs before an app is rebuilt.

"post_rebuild"

Event that runs after an app is rebuilt.

Since: 3.0.0

"pre_start"

Event that runs before an app starts up.

This is useful if you want to start up any support services before an app stars.

Since: 3.0.0

"post_start"

Event that runs after an app is started.

This is useful if you want to perform additional operations after an app starts such as running additional build commands.

Since: 3.0.0

"pre_stop"

Event that runs before an app stops.

Since: 3.0.0

"post_stop"

Event that runs after an app stop.

Since: 3.0.0

"pre_uninstall"

Event that runs before an app is uninstalled.

This is useful if you want to add or remove parts of the uninstall process. For example, it might be nice to persist a container whose data you do not want to replace in a rebuild and that cannot persist easily with a volume.

Since: 3.0.0

"post_uninstall"

Event that runs after an app is uninstalled.

This is useful if you want to do some additional cleanup steps after an app is uninstalled such as invalidating any cached data.

Since: 3.0.0