Crossbar.io Shell (cbsh) is a tool belt for Crossbar.io featuring:
- an interactive shell to access Crossbar.io Fabric Center and manage your Crossbar.io Fabric nodes from one central place and command line
- a service scaffolding system that gets you started quickly using templates for Crossbar.io and Autobahn:
For Linux (64-bit), we provide cbsh as a one-file executable that is completely statically linked and should run on basically any Linux distribution.
Run this command to download the latest version of the Crossbar.io Shell executable
and install to /usr/local/bin
:
sudo curl -L https://s3.eu-central-1.amazonaws.com/download.crossbario.com/cbsh/linux/cbsh -o /usr/local/bin/cbsh
Apply executable permissions to the binary:
sudo chmod +x /usr/local/bin/cbsh
Test the installed binary:
oberstet@thinkpad-t430s:~$ which cbsh
/usr/local/bin/cbsh
oberstet@thinkpad-t430s:~$ cbsh version
Crossbar.io Shell 18.4.5
Platform : Linux-4.4.0-119-generic-x86_64-with-glibc2.3.4
Python (language) : 3.6.5
Python (implementation) : CPython
Autobahn : 18.4.1
Docker Compose : not installed
Sphinx : 1.7.2
Frozen executable : yes
Executable SHA256 : e45ecb24515b7a75521ecfb2084ca93745ca941e0b5146e0d0fe11b94834b85c
As the installation path /usr/local/bin
is in the search PATH of most Linux systems by default,
cbsh will be automatically available for all users on the system.
To update cbsh at a later time, just download the new version by rerunning above curl
command.
cbsh should run on any system with a recent Python 3, and we publish releases on PyPI.
We recommend installation into a dedicated Python virtual environment:
python3 -m venv cbsh
cbsh/bin/pip3 install --no-cache cbsh
Note
To install a specific version, use eg cbsh==18.4.1
in above last command.
To check the installation:
oberstet@thinkpad-t430s:~$ cbsh/bin/cbsh version
Crossbar.io Shell 18.4.6-dev2
Platform : Linux-4.4.0-119-generic-x86_64-with-glibc2.9
Python (language) : 3.5.2
Python (implementation) : CPython
Autobahn : 18.4.1
Docker Compose : 1.21.0
Sphinx : 1.7.2
Frozen executable : no
You can also activate the Python virtual environment by doing (on Unix):
source cbsh/bin/activate
This will make the Python of the virtual environment, and the cbsh installed therein available without qualifying paths - in the current terminal session.
Finally, you can add the directory path cbsh/bin/
to your environment search PATH,
eg on Unix systems by export PATH=${HOME}/cbsh/bin:${PATH}
. That will make cbsh
available in terminal sessions automtically.
To update cbsh at a later time, run:
cbsh/bin/pip3 install --no-cache --upgrade cbsh
Requires Microsoft Windows 10 Professional or Enterprise 64-bit https://www.docker.com/docker-windows https://store.docker.com/editions/community/docker-ce-desktop-windows
Get Docker Community Edition for Windows
Docker for Windows is available for free.
Requires Microsoft Windows 10 Professional or Enterprise 64-bit. For previous versions get Docker Toolbox. By downloading this, you agree to the terms of the Docker Software End User License Agreement
Please refer to the documentation for description and usage cbsh.