eb local
Description
Use eb local run to run your application's containers locally in Docker. Check the application's container status with eb local status. Open the application in a web browser with eb local open. Retrieve the location of the application's logs with eb local logs.
eb local setenv and eb local printenv let you set and view environment variables that are provided to the Docker containers that you run locally with eb local run.
You must run all eb local commands in the project directory of a Docker application that has been initialized as an EB CLI repository by using eb init.
Note
Use eb local on a local computer running Linux or macOS. The command doesn't support Windows.
Before using the command on macOS, install Docker for Mac, and ensure that boot2docker isn't installed (or isn't in the execution path). The eb local command tries to use boot2docker if it's present, but doesn't work well with it on macOS.
Syntax
eb local run
eb local status
eb local open
eb local logs
eb local setenv
eb local printenv
Options
eb local run
|
Name |
Description |
|---|---|
|
|
Sets environment variables that the EB CLI will pass to the local Docker containers. In multicontainer environments, all variables are passed to all containers. |
|
|
Maps a port on the host to the exposed port on the container. If you don't specify this option, the EB CLI uses the same port on both host and container. This option works only with Docker platform applications. It doesn't apply to the Multicontainer Docker platform. |
eb local status
eb local open
eb local logs
eb local setenv
eb local printenv
| Name | Description |
|---|---|
Output
eb local run
Status messages from Docker. Remains active as long as application is running. Press Ctrl+C to stop the application.
eb local status
The status of each container used by the application, running or not.
eb local open
Opens the application in a web browser and exits.
eb local logs
The location of the logs generated in your project directory by applications running locally under eb local run.
eb local setenv
None
eb local printenv
The name and values of environment variables set with eb local setenv.
Examples
eb local run
~/project$ eb local run
Creating elasticbeanstalk_phpapp_1...
Creating elasticbeanstalk_nginxproxy_1...
Attaching to elasticbeanstalk_phpapp_1, elasticbeanstalk_nginxproxy_1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: fpm is running, pid 1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: ready to handle connectionseb local status
View the status of your local containers:
~/project$ eb local status
Platform: 64bit Amazon Linux 2014.09 v1.2.1 running Multi-container Docker 1.3.3 (Generic)
Container name: elasticbeanstalk_nginxproxy_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): 80
Full local URL(s): 127.0.0.1:80
Container name: elasticbeanstalk_phpapp_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): None
Full local URL(s): Noneeb local logs
View the log path for the current project:
~/project$ eb local logs
Elastic Beanstalk will write logs locally to /home/user/project/.elasticbeanstalk/logs/local.
Logs were most recently created 3 minutes ago and written to /home/user/project/.elasticbeanstalk/logs/local/150420_234011665784.eb local setenv
Set environment variables for use with eb local run.
~/project$ eb local setenv PARAM1=valuePrint environment variables set with eb local setenv.
~/project$ eb local printenv
Environment Variables:
PARAM1=value