Merge pull request hyperledger-cello#731 from dodo920306/task/provide-first-4-lessons-of-the-tutorial

Elaborate docs and create the first 7 lessons of the tutorials

Author: yeasy

Makefile

@@ -145,6 +145,9 @@ deep-clean: ##@Clean Stop services, clean docker images and remove mounted local
 	make clean-images
 	rm -rf $(LOCAL_STORAGE_PATH)
 
+docs:
+	make doc
+
 doc: ##@Documentation Build local online documentation and start serve
 	command -v mkdocs >/dev/null 2>&1 || pip install -r docs/requirements.txt || pip3 -r docs/requirements.txt
 	mkdocs serve -f mkdocs.yml
@@ -216,7 +219,7 @@ images: api-engine docker-rest-agent fabric dashboard
 
 api-engine: 
 	docker build -t hyperledger/cello-api-engine:latest -f build_image/docker/common/api-engine/Dockerfile.in ./ --platform linux/$(ARCH)
-	
+
 docker-rest-agent:
 	docker build -t hyperledger/cello-agent-docker:latest -f build_image/docker/agent/docker-rest-agent/Dockerfile.in ./ --build-arg pip=$(PIP) --platform linux/$(ARCH)
 
@@ -226,15 +229,19 @@ fabric:
 dashboard:
 	docker build -t hyperledger/cello-dashboard:latest -f build_image/docker/common/dashboard/Dockerfile.in ./
 
+server:
+	docker compose -f bootup/docker-compose-files/docker-compose.server.dev.yml up -d --force-recreate --remove-orphans
 
-
+agent:
+	docker compose -f bootup/docker-compose-files/docker-compose.agent.dev.yml up -d --force-recreate --remove-orphans
 
 .PHONY: \
 	all \
 	license \
 	check \
 	check-api \
 	check-dashboard \
+    docs \
 	doc \ 
 	help \
 	docker \
@@ -253,4 +260,6 @@ dashboard:
 	clean-images \
 	start-docker-compose \
 	stop-docker-compose \
-	images \
+	images \
+	server \
+	agent

README.md

@@ -1,4 +1,4 @@
-![Cello](docs/images/favicon.png)
+![Cello](docs/images/logo.svg)
 
 [![Release](https://img.shields.io/github/v/release/hyperledger-cello/cello)](https://github.com/hyperledger-cello/cello/releases)
 [![Build Status](https://github.com/hyperledger/cello/actions/workflows/docker-image.yml/badge.svg)](https://github.com/hyperledger/cello/actions/workflows/docker-image.yml)

bootup/docker-compose-files/docker-compose.agent.dev.yml

@@ -0,0 +1,27 @@
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+services:
+  cello-docker-agent:
+    image: hyperledger/cello-agent-docker
+    container_name: cello-docker-agent
+    hostname: cello.docker.agent
+    restart: always
+    ports:
+      - "2375:2375"
+      - "5001:5001"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - DOCKER_URL=unix://var/run/docker.sock
+      - STORAGE_PATH=${CELLO_STORAGE_PATH:-/opt/cello}/hyperledger
+    networks:
+      - cello-net
+
+networks:
+  cello-net:
+    name: cello-net
+
+volumes:
+  cello-docker-agent:

bootup/docker-compose-files/docker-compose.server.dev.yml

@@ -0,0 +1,67 @@
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+services:
+  cello-dashboard:
+    image: hyperledger/cello-dashboard
+    container_name: cello-dashboard
+    ports:
+      - "${DASHBOARD_SERVICE_PORT}:8081"
+    networks:
+      - cello-net
+    depends_on:
+      - cello-api-engine
+
+  # pg database
+  cello-postgres:
+    image: postgres:12.0
+    container_name: cello-postgres
+    restart: unless-stopped
+    environment:
+      - POSTGRES_DB=api_engine
+      - POSTGRES_USER=postgres
+      - POSTGRES_PASSWORD=123456
+    ports:
+      - "5432:5432"
+    volumes:
+      - ${CELLO_STORAGE_PATH:-/opt/cello}/pgdata:/var/lib/postgresql/data
+    networks:
+      - cello-net
+
+  # api engine service of cello 
+  cello-api-engine:
+    image: hyperledger/cello-api-engine
+    container_name: cello-api-engine
+    restart: unless-stopped
+    stdin_open: true
+    dns_search: .
+    environment:
+      - GODEBUG=netdns=go
+      - DB_NAME=api_engine
+      - DB_USER=postgres
+      - DB_PASSWORD=123456
+      - DB_HOST=cello-postgres
+      - CELERY_BROKER_URL=redis://redis
+      - DB_PORT=5432
+      - DEBUG=True
+      - CORE_VM_ENDPOINT=unix:///host/var/run/docker.sock
+      - FABRIC_LOGGING_SPEC=INFO
+      - API_ENGINE_ADMIN_EMAIL=admin@cello.com
+    ports:
+      - "8080:8080"
+    volumes:
+      - ${CELLO_STORAGE_PATH:-/opt/cello}:/opt/cello
+    networks:
+      - cello-net
+    depends_on:
+      - cello-postgres
+
+networks:
+  cello-net:
+    name: cello-net
+
+volumes:
+  cello-api-engine:
+  cello-postgres:
+  cello-dashboard:

docs/concepts.md

@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 hero: All concepts related to cello
 
 # Concepts

docs/contributing.md

@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 [//]: # (SPDX-License-Identifier: CC-BY-4.0)
 
 ## Introduction

docs/design/arch.md

@@ -1,3 +1,8 @@
+---
+hide:
+  - navigation
+---
+
 # Architecture Design
 
 Here we discuss the architecture design for the mangement services on the Master node.

docs/faq.md

@@ -1,7 +1,5 @@
 ## Questions
 
-* [What is cello?](#what-is-cello)
-
 ### What is cello?
 
 Hyperledger Cello is a blockchain provision and operation system, which helps manage blockchain networks in an efficient way.