A Distributed Java Reverse Proxy
Start Carapace by running ./run.sh
script. This just launch the server, the ui and load a ready to use dynamic configuration.
Server will start at http://localhost:8001/ui/#/
and https://localhost:4001/ui/#/
with no authentication required.
To launch/update the ui only, run ./carapace-ui/deploy.sh
To bundle the project into a .zip archive for a standalone installation run mvn clean install -DskipTests -Pproduction
. You'll find the generated zip in carapace-server/target/carapace-server-X.Y.Z-SNAPSHOT.zip
To install Carapace, just unzip the carapace.zip archive and then run ./bin/service server start [custom-server.properties]
(default server.properties is loaded).
The server will start at hostname:port
as defined in the server.properties file loaded.
You can build carapace docker image by running:
mvn clean install -DskipTests -Pproduction
docker/build.sh
Then you can run the container and the admin interface will be listening on 0.0.0.0:8001
docker run -p 8001:8001 carapace/carapace-server:latest
You can also pass system properties using docker option -e
with the prefix CARAPACE
:
docker run -p 8001:8001 -e CARAPACE_mode=cluster -e CARAPACE_zkAddress=localhost:2181 carapace/carapace-server:latest
You can run a simple 1-node cluster using the docker-compose.yml file. This starts a Carapace node (with embedded bookkeeper and herddb) and Zookeeper. The replication factor of bookkeeper in this case will be set to 1.
docker compose up -d