Skip to main content
Version: v0.4

Quick Start

Note:

Walrus is alpha-quality software. It is under rapid development. Subsequent versions may introduce API changes that are not compatible.

Deployment

Prerequisites:

  • A Linux server with no less than 4 CPU cores, 8GiB memory.
  • At least 50GB of free disk space.
  • Docker installed, if not please refer to the Docker official documentation.
  • Server ports 80 and 443 are open.

Execute the following command to start the Walrus service:

sudo docker run -d --privileged --restart=always -p 80:80 -p 443:443 --name walrus sealio/walrus:v0.4.1

For more detailed installation requirements, please refer to installation.

Access UI

  1. Access Walrus UI through https://<server-address>.

  2. Login to Walrus with the username admin and the initial administrator password, and set a new password and Walrus's access address as prompted by the UI.

Run the following command on the server to get the initial administrator password.

sudo docker logs walrus 2>&1 | grep "Bootstrap Admin Password"

qs-first-login

Add a Kubernetes Cluster as Deployment Target

Prerequisites:

  • A Kubernetes cluster that can be reached by the Walrus server.
  1. Click the Application Management menu in the navigation bar to go to the default project view by default.
  2. Click the Connectors tab.
  3. Click the New Connector button, and select Kubernetes type.
  4. Fill in the cluster name and KubeConfig file, and click save.

qs-add-connector

Create Environment

  1. Click the Environment tab, and click the New Environment button.

qs-create-env

  1. Enter the environment name, such as dev.
  2. Click Add Connector button, and select the Kubernetes connector added in the previous step.
  3. Click save.

qs-create-env2

Deploy Service

  1. In the environment list page, click the environment name created in the previous step to enter the environment view.

qs-go2env

  1. Click the New button and select Service.

qs-create-svc

  1. Fill in the service name, such as myapp, and make sure the template is selected as kubernetes-containerservice.
  2. Enter nginx image in the Image Name of the template configuration, and click confirm.

qs-create-svc2

  1. Click the Save and Deploy button to complete the creation of the service.
  2. After the service deployment is complete, you can view components, logs, execute terminal commands, access the address of this nginx service, etc.
  • View deployment logs.

qs-logs

  • View component logs.

qs-res-logs

  • Open terminal.

qs-res-exec

Congratulations, you have deployed your first application using Walrus!