Deploying with the All-In-One Docker Container
The all-in-one container sets up the Stratos components in a single container.
Requirements:
You will need to have installed Docker, see Docker Installation Documentation.
Quick Start
Run Stratos in Docker locally:
Once that has finished, you can then access Stratos by visiting https://localhost:4443.
You can configure a local admin account and set the password for future logins.
Note regarding the Stratos Session Store Secret
Stratos uses a secret to protect the Session cookie it uses to identify users. By default it will generate a random value for this secret.
We recommend configuring an alphanumeric secret of your choice by setting the SESSION_STORE_SECRET environment variable.
This can be done by adding the following to the docker run command shown in the section below:
Configuring a local user account in place of a UAA
By default the All-in-one image requires a UAA for user authentication. If this is not desired, the image can be configured to use a Stratos local user account. Edit the file deploy/all-in-one/config.all-in-one.properties and uncomment the following lines before building the container.
Building the container:
To build the container, change directory to the root of the project and open a command prompt:
Note: The Dockerfile for all-in-one is in the
deployfolder and not thedeploy/all-in-onefolder.
Note: If you are using Docker for Mac and you get an error 137 when building, you should increase the memory available to Docker (via Preferences > Advanced) and try again.
Bring up the container with:
Stratos should now be accessible at the following URL:
https://localhost:4443
If using a UAA, you will be presented with the Stratos Setup welcome screen - you will need to enter your UAA information to configure Stratos. Once complete, you will be able to login with your credentials. If you have configured the container to use a local user account instead of a UAA, log in with the credentials specified in the configuration file.
Persisting the Database
Each time you start and stop the Docker All-In-One container, you will lose any your UAA configuration, endpoints and connections that you have made in Stratos.
In order to persist the Stratos database file between runs of the Docker container you can store the database file outside of the docker container.
Create a folder where the database folder will be stored, e.g.
When starting the Docker container, mount a volume for this folder and pass this via the SQLITE_DB_DIR environment variable, e.g.
Now each time you stop and start the container, Stratos will maintain the database file.
Note: You can validate that the environment variable has been correctly set and check the database file location by observing the log file of the Docker container. You should see a log message similar to:
SQLite Database file: /var/stratos-db/console-database.db
Pushing the All-In-One Docker Image to Cloud Foundry
Note: We recommend setting the session store secret - please use a manifest file for this and set the
SESSION_STORE_SECRETenvironment variable.
The All-In-One Docker Image can be pushed to Cloud Foundry.
Firstly, build the image and push it to a Docker registry, so that it is available to Cloud Foundry, e.g. to build and push to Docker Hub, in the project root directory run:
Where MY-DOCKER_ORG is your Docker Hub organization.
You can now push this image directly to Cloud Foundry with:
The log output of the push command will include the URL where the Stratos application can be accessed in a browser, e.g.
Note: In this example we are pushing with the application name
stratos
Note: By default the All-in-one image has SSL Validation disabled when authenticating with Cloud Foundry and the UAA - this allows it to work out of the box with environments like PCF Dev. If this is not the behavior you desire, edit the file
deploy/all-in-one/config.all-in-one.propertiesand change theSKIP_SSL_VALIDATIONas desired before building and publishing the image.