example-bospy-app

How to build a bos app using a container image using the official bospy base image.

pre-work

The easiest way to build an app from scratch is to fork this example repo.

git clone https://github.com/jamesryancoleman/example-bospy-app NEW_NAME

This will put a folder structure like this in your current directory:

app-name
├── Dockerfile
├── requirements.txt
├── src
│   └── app.py
└── tests (optional)
    └── test_app.py

Create a new virtual environment and activate it so autocomplete works in your IDE.

cd app-name
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Next pull the official bospy base image to ensure its available on your system.

docker pull jamescoleman/bospy

Now you're ready to build and deploy your app.

Build your app

In your Dockerfile update the Dockerfile per the comments. Most critically, a new bos.name.

Build the app and tag it.

docker build -t APP_NAME .

Your new app will appear automatically in the orchestator. Just drag on to the Activate Apps view to launch.