Running Hippo on your machine requires three steps:
- Install Spin
- Boot Bindle
- Boot hippo-server
Hippo deploys applications using Spin, a framework for building and running event-driven microservice applications with WebAssembly components.
Download the latest release of Spin. Extract the Spin binary and move it to a directory that is in your $PATH.
$ mv spin /usr/local/bin/
No further configuration is necessary.
Applications are bundled up as a bindle. Bindles are collected together in a
bindle server that you can search. Hippo
bindle under the hood for storing and organizing applications.
First, set up a local installation of Bindle. This is where Hippo will publish revisions of your application.
- Download the latest release
of bindle. Extract the
bindle-serverbinaries and move them to a directory on your $PATH.
$ mv bindle bindle-server /usr/local/bin/
To start the server, simply run
$ bindle-server --unauthenticated
If you would like to see the available options, use the
bindle-server listens on port 8080. You can verify it is running
by issuing a request to Bindle:
$ bindle --server http://localhost:8080/v1 search === Showing results 1 to 0 of 0 (limit: 50)
Next, we will compile hippo-server from source.
Install the following to compile hippo-server from source:
hippo-server is written in C# using the ASP.NET framework. The Web UI uses Angular as the front-end web framework and Bulma as the design framework, which (along with some other packages) is managed via npm.
To build the project, run:
$ git clone https://github.com/deislabs/hippo $ cd hippo/src/Web $ dotnet build
Then run hippo-server, pointing at your local Bindle instance:
$ export BINDLE_URL=http://localhost:8080/v1 $ dotnet run
Once that’s done, proceed to Step 2: Deploy an Application