Blackbird Reference Architecture
Note: this reference architecture is for illustrative purposes only. It is not tuned for production!
- MacOS or Linux system
- Kubernetes 1.6 or later cluster. Unfortunately, Minikube does not have full RBAC support yet, and the reference architecture uses RBAC.
kubectlconfigured to talk to your cluster
- A Docker registry account on Docker Hub, Google Container Registry, Amazon ECR, Quay, etc.
Run the install script which will clone the Blackbird repository and install the Forge and Telepresence clients locally.
curl https://raw.githubusercontent.com/datawire/blackbird/master/blackbird-install.sh | bash
You'll then want to deploy the Blackbird repository into your cluster. You can do this with Forge.
cd blackbird forge setup # sets up your Docker credentials forge deploy # deploys all the demo services
Note that the deployment may take awhile. The reference architecture installs demo Java, NodeJS, and Python services, so it will take a few minutes to download the necessary dependencies and build the services.
Once deployment is complete, you should have a number of pods running in the
kubectl get pod -n datawire NAME READY STATUS RESTARTS AGE ambassador-77496977dd-fr8rp 2/2 Running 0 3h java-spring-api-stable-69c97b99c9-xm9kc 1/1 Running 0 5h nodejs-api-stable-646fbc999d-zh2qd 1/1 Running 0 5h python-api-stable-5799cdc89d-wg85h 1/1 Running 0 5h ui-stable-749846897c-hk466 1/1 Running 0 4h
Get the external IP address of the Ambassador service, and open that IP in your browser. You should see the Reference Architecture walk-through.
kubectl get svc ambassador -n datawire NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE ambassador 10.43.245.71 22.214.171.124 80:31807/TCP 5h