区块链商店系统开发实操

# GZ036 区块链技术应用赛项赛题第1套(模块一)
### 模块一 区块链搭建部分

:::info{title="相关信息"}
相关信息 学习记录
:::



![image.png](/static/img/d171e86c3f7320b785b5a56de9494340.image.webp)

#### 1-2-1： 搭建区块链系统并验证
##### （1）采用默认配置搭建区块链网络

![image.png](/static/img/9e1de193fdabd882f5e7938df2b4ec58.image.webp)

成功效果图 出现 `All completed ` 表示部署成功
![image.png](/static/img/e83fc9e0b765eec38cd90ff56d1d3124.image.webp)

启动成功效果图
![image.png](/static/img/cb42019f538e9c666395125549f22593.image.webp)
##### （2）通过命令验证区块链节点进程运行状况
![image.png](/static/img/a7d48409e33c2fde83c53527f3ce0931.image.webp)
##### （3）通过命令验证区块链连接状态和共识状态日志输出
连接状态
![image.png](/static/img/954bfe0825b555ec1e338200a5d003eb.image.webp)
共识状态
![image.png](/static/img/9b8ffe19628a598c8ac95fe68653dcb7.image.webp)
#### 1-2-2：搭建区块链系统管理平台并验证
##### （1）配置控制台，管理相关证书并启动
配置控制台以及管理相关证书
![image.png](/static/img/bfcb2cb9e796f030b549f718dbc08447.image.webp)
启动成功效果图
![image.png](/static/img/9923c707dec11881c6eb698da86e0417.image.webp)
##### （2）使用控制台安装HelloWorld智能合约

![image.png](/static/img/d9767cb532268aa68799e07bee443641.image.webp)
##### （3）使用控制台完成HelloWorld智能合约的set与get操作
调用set函数

![image.png](/static/img/4d9774675047434a3b98c4fc48d8db77.image.webp)

调用get函数

![image.png](/static/img/92cf7545118c3c0877db60ed1927b74b.image.webp)
##### （4）使用控制台查看区块链中区块高度

![image.png](/static/img/9eb0051b2553881da92d0d48f89b68aa.image.webp)

#### 1-2-3：区块链节点运维
##### （1）获取指定区块链节点输出等级为警告级，并设置日志存储阈值位100MB并验证
输出指定区块节点等级为警告级
![image.png](/static/img/81e04ac02c56e48efdcf9542396e8324.image.webp)
修改配置文件
![image.png](/static/img/6e8f118204c55e94a47dd0ffede011be.image.webp)
log配置文件
![image.png](/static/img/64bfafc68ab96f569fdcc2e6a70206b6.image.webp)
##### （2）通过给定工具完成新节点（node4）配置
创建新节点node4
![image.png](/static/img/382498f47a263e60a7c4ca22f36f9423.image.webp)
拷贝配置文件、启动文件以及群组文件到新节点中

![image.png](/static/img/9c1a8c0dcf3f56801b10ac8ce72b40a3.image.webp)
![image.png](/static/img/6faa498f0759f9a04a1fd886d2bd324e.image.webp)
修改配置文件 config.ini
![image.png](/static/img/033d3369da0aa38da80f8c7ca40ec432.image.webp)
重启所有节点
![image.png](/static/img/a5d1b74ec402144c3f4841602e2210e9.image.webp)

检查进程、连接与共识

进程 5 个新节点启动成功
![image.png](/static/img/a8bf57baab28c02955243fe3f7a032cd.image.webp)
与其他节点连接成功
![image.png](/static/img/c2154b6521026bb3dab33144b1a64a24.image.webp)

检查共识 此时的节点还是**游离节点**还未加入共识
![image.png](/static/img/09ce1a192396f8547a0ce4345a6deacc.image.webp)
##### （3）启动新节点加入区块链系统并验证
加入共识
获取新节点 id
![image.png](/static/img/9311107e6aad581e5ea45e9e6d0150b5.image.webp)
在控制台里面添加为观察节点
![image.png](/static/img/a43317a4b60d7037bd2756f8c5f4f94c.image.webp)
添加为共识节点
![image.png](/static/img/935476fb4df348e4eb000aad075b038c.image.webp)
再次检查共识，共识成功
![image.png](/static/img/c48e33bbcc546e82727a921e0e904e08.image.webp)

#### 1-2-4：区块链网络运维
##### （1）设置区块链系统黑名单，将node3设为黑名单禁止连接，并验证
把所有的节点config.ini 的黑名单里面添加node3的id


![image.png](/static/img/748c70d970d72fd59fe49c976bc4ae2e.image.webp)
验证node3没有加入连接所以连接数为3
![image.png](/static/img/a87e77b126696cb23551641cd227da0c.image.webp)

##### （2）设置系统中区块打包最大交易数量设为2000 

![image.png](/static/img/0ac51a3db90a19b5c14f586895775cc2.image.webp)
##### （3）验证区块最大打包交易数量情况
![image.png](/static/img/d288356f17993a46a64af38b4302af90.image.webp)

至此所有演示就结束了

#### 下载
原题下载 [GZ036 区块链技术应用赛项赛题第1套](https://sumhyh.lanzouv.com/iBW922a9kehi)

GZ036 区块链技术应用赛项赛题第1套(模块一)

# GZ036 区块链技术应用赛项赛题第1套(模块二)
### 模块二 食品溯源智能合约部分

:::info{title="相关信息"}
相关信息 学习记录
:::



![image.png](/static/img/4360bffb3bd8935d0666c5f93d36ac06.image.webp)
#### 练习代码
##### Roles.sol

```js
pragma solidity ^0.4.25;
//请在本文件实现 Roles 库,定义一个结构体 Role,结构体内只有一个映射元素,用来存储某地址是否在该映射中,给地址进行授权
//库中定义三个方法,第一个方法在映射中添加地址,第二个方法在映射中删除地址,第三个方法判断某给定地址是否在授权映射中
//上述三个方法都是内部方法, 需在方法开始进行错误处理,参数都为 Role storage role 和 address account

library Roles {
 




}

```
##### Producer.sol

```js
pragma solidity ^0.4.25;
/*
请在本文件中实现生产者Producer合约
1. 请引入 Role 库
2.定义两个事件:添加生产者和删除生产者事件,参数为添加或删除的地址,都为该事件的索引
3.定义一个私有的 Role 类型的结构体用来存储生产者地址以及其是否授权的信息
4.创建一个修饰符,该修饰符的作用是判断当前合约调用者是否被授权,若未授权,则报错
5.创建给某生产者地址授权的方法(增加生产者地址至映射中),并触发事件
6.创建给某生产者地址移除授权的方法,并触发事件
7.在最开始创建一个构造函数,构造函数中调用给某生产者地址授权的方法
*/
import "./Roles.sol";

contract Producer {
 

 




 
}
```
##### Retailer.sol

```js
pragma solidity ^0.4.25;
/*
请在本文件中实现超市Retailer合约
参考生产者合约要求
*/

import "./Roles.sol";

contract Retailer {
 




 
}
```
##### Distributor.sol

```js
pragma solidity ^0.4.25;
/*
请在本文件中实现中间商Distributor合约
参考生产者合约要求
*/

import "./Roles.sol";

contract Distributor {
 




 
}
```
##### FoodInfoItem.sol

```js
pragma solidity >=0.4.22 <0.5.0;
pragma experimental ABIEncoderV2;
/*
请在本文件实现食品信息管理合约
1.定义食品信息变量,包括:
 a.uint[] 保存食品流转过程中各个阶段的时间戳
 b.string[] 保存食品流转过程各个阶段的用户名
 c.address[] 保存食品流转过程各个阶段的用户地址信息（和用户一一对应）
 d.uint8[] 保存食品流转过程中各个阶段的质量
 e.食物名称
 f.当前用户名称
 g.质量（0=优质 1=合格 2=不合格）
 h.状态（0:生产 1:分销 2:出售）
 i._owner 食物创建人
2. 在构造函数中对上述变量进行初始化
 a.存入当前时间
 b.状态为生产
 c._owner 为当前合约调用者
 d.其他信息作为参数传入
3.实现中间商添加食品信息方法:
 a.首先进行错误处理,需要食品状态信息为生产,_owner为当前合约调用者,否则报错
 b.更新食品信息:存入当前时间,状态为分销
 c.其他信息作为参数传入
4.实现超市添加食品信息方法,参考上一步
5.实现返回食品溯源信息方法,返回信息有食品流转过程中的:时间戳,用户名称,用户地址信息,质量
6.实现返回食品信息方法,返回信息有:时间戳,用户名,食品名称,当前用户名,用户地址,食品质量
*/

contract FoodInfoItem{
 uint[] _timestamp; //保存食品流转过程中各个阶段的时间戳
 string[] _traceName; //保存食品流转过程各个阶段的用户名
 address[] _traceAddress; //保存食品流转过程各个阶段的用户地址信息（和用户一一对应）
 uint8[] _traceQuality; //保存食品流转过程中各个阶段的质量
 string _name; //食物名称
 string _currentTraceName; //当前用户名称
 uint8 _quality; //质量（0=优质 1=合格 2=不合格）
 uint8 _status; //状态（0:生产 1:分销 2:出售）
 address _owner;

 constructor (string name, string traceName, uint8 quality, address producer) public {
 _timestamp.push(now);
 _traceName.push(traceName);
 _traceAddress.push(producer);
 _traceQuality.push(quality);
 _name = name;
 _currentTraceName = traceName;
 _quality = quality;
 _status = 0;
 _owner = msg.sender;
 }

 function addTraceInfoByDistributor( string traceName, address distributor, uint8 quality) public returns(bool) {
 
 
 //补充代码



 }

 function addTraceInfoByRetailer( string traceName, address retailer, uint8 quality) public returns(bool) {
 //补充代码
 


 }

 function getTraceInfo() public constant returns(uint[], string[], address[], uint8[]) {
 
 //补充代码

 }

 function getFood() public constant returns(uint, string, string, string, address, uint8) {
 //补充代码
 

 }

}
```
##### Trace.sol

```js
pragma solidity >=0.4.22 <0.7.0;
pragma experimental ABIEncoderV2;
import "./FoodInfoItem.sol";
import "./Distributor.sol";
import "./Producer.sol";
import "./Retailer.sol";
/*
请在本文件中按照提示实现对应的方法
*/

//食品工厂合约，负责具体食品溯源信息的生成
contract Trace is Producer, Distrisbutor, Retailer{

 //创建映射foods,存储食品溯源 id 到具体食品溯源合约地址的映射表
 //创建一个数组存储食品列表foodList
 //补充代码



 //构造函数
 constructor(address producer, address distributor, address retailer) 
	public Producer(producer) 
	Distributor(distributor) 
	Retailer(retailer){

 }
 /*生成食品溯源信息接口:
 1.只有Producer能调用
 2.首先进行错误处理,在 foods 映射中不存在当前食物,否则报错
 3.对FoodInfoItem合约进行初始化,传入参数name, traceName, quality, msg.sender
 4.将初始化后的合约地址传入 foods 映射
 5.在foodList数组中存入新食物的traceNumber
	 */
 function newFood(string name, uint256 traceNumber, string traceName, uint8 quality) 
	public onlyProducer returns(address)
 {
 require(foods[traceNumber] == address(0), "traceNumber already exist");
 FoodInfoItem food = new FoodInfoItem(name, traceName, quality, msg.sender);
 //补充代码

 
 return food;
 }

 /*食品分销过程中增加溯源信息的接口
 1.只有Distributor能调用
 2.首先进行错误处理,在 foods 映射中存在当前食物,否则报错
 3.调用 FoodInfoItem 合约中的中间商添加食品信息方法
 */
 function addTraceInfoByDistributor(uint256 traceNumber, string traceName, uint8 quality) 
	public onlyDistributor returns(bool) {
 require(foods[traceNumber] != address(0), "traceNumber does not exist");
 return FoodInfoItem(foods[traceNumber]).addTraceInfoByDistributor( traceName, msg.sender, quality);
 }

 /*食品出售过程中增加溯源信息的接口
 1.只有Retailer能调用
 2.首先进行错误处理,在 foods 映射中存在当前食物,否则报错
 3.调用 FoodInfoItem 合约中的超市添加食品信息方法
 */
 function addTraceInfoByRetailer(uint256 traceNumber, string traceName, uint8 quality) 
	public onlyRetailer returns(bool) {
 //补充代码
 }

 /*获取食品溯源信息接口
 1.首先进行错误处理,在 foods 映射中存在当前食物,否则报错
 2.调用FoodInfoItem合约中的获取食品溯源信息方法
 string[] 保存食品流转过程中各个阶段的相关信息
 address[] 保存食品流转过程各个阶段的用户地址信息（和用户一一对应）
 uint8[] 保存食品流转过程中各个阶段的状态变化
 */
 function getTraceInfo(uint256 traceNumber) public constant returns(uint[], string[], address[], uint8[]) {
 //补充代码
 }
 /*获取食品信息接口
 1.首先进行错误处理,在 foods 映射中存在当前食物,否则报错
 2.调用FoodInfoItem合约中的获取食品信息方法
 */
 function getFood(uint256 traceNumber) public constant returns(uint, string, string, string, address, uint8) {
 //补充代码
 }
 /*获取所有食品信息列表接口
 返回foodList
 */
 function getAllFood() public constant returns (uint[]) {
 return foodList;
 }
}
```
#### 完整代码
##### Roles.sol

```js

// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

library Roles{
 struct Role{
 mapping (address => bool) bearer;
 }

//判断地址是否存在
function has(Role storage role,address amount) internal view returns (bool){
 require(amount != address(0));//判断地址不为空
 return role.bearer[amount];//返回一个布尔值
}
 
//添加角色
function add(Role storage role,address amount) internal {
 require(!has(role, amount));
 role.bearer[amount] = true;
}
/**这个函数用于向特定角色添加成员。它接受一个 Role 结构体和一个地址作为参数。在函数内部，
它首先调用 has 函数检查地址是否已经具有该角色，
如果没有，则将地址添加到映射中，并将其值设置为 true，表示该地址拥有该角色。
*/
 
//删除角色
function remove(Role storage role,address amount) internal {
 require(has(role, amount));
 role.bearer[amount] = false;
}
 
/**
这个函数用于从特定角色中移除成员。它接受一个 Role 结构体和一个地址作为参数。
在函数内部，它首先调用 has 函数检查地址是否具有该角色，
如果是，则将地址从映射中移除，并将其值设置为 false，表示该地址不再拥有该角色。
*/
}
```
##### Producer.sol

```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

import "./Roles.sol";

contract Producer{
 using Roles for Roles.Role;
 Roles.Role private _produce;
event producerAdded(address amount);
event producerRemoved(address amount);
 
constructor(address produce) public {
 _addProducer(produce);
 
}
 
function _addProducer(address amount) internal {
 _produce.add(amount);
 emit producerAdded(amount);
}
 
function _removeProducer(address amount) internal {
 _produce.remove(amount);
 emit producerRemoved(amount);
}
 
function isProducer(address amount ) public view returns (bool){
 return _produce.has(amount);
}
 
modifier onlyProducer(){
 require(isProducer(msg.sender),"you are not deployer");
 _;
}
 
function addProducer(address amount) public onlyProducer{
 _addProducer(amount);
}
 
/**
这个函数用于将调用者从生产商角色中移除。
任何人都可以调用此函数来将自己从生产商角色中移除。它调用了 _removeProducer 函数来执行实际的移除操作。
*/
function removeProducer() public {
 _removeProducer(msg.sender);
 
}
}
```
##### Retailer.sol

```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

import "./Roles.sol";

contract Retailer{
 using Roles for Roles.Role;
 Roles.Role private _retailer;
event retailerAdded(address amount);
event retailerRemoved(address amount);
 
constructor(address Retailer) {
 _addRetalier(Retailer);
 
}
function _addRetalier(address amount) internal {
 _retailer.add(amount);
 emit retailerAdded(amount);
}
 
function _removeRetailer(address amount) internal {
 _retailer.remove(amount);
 emit retailerRemoved(amount);
}
 
function isRetailer(address amount) public view returns (bool){
 return _retailer.has(amount);
}
 
modifier onlyRetailer() {
 require(isRetailer(msg.sender),"you are not deployer");
 _;
}
 
function addRetailer(address amount) public {
 _addRetalier(amount);
}
 
function removeRetailer() public {
 _removeRetailer(msg.sender);
}
}
```
##### Distributor.sol

```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

import "./Roles.sol";

contract Distributor{
 using Roles for Roles.Role;
 Roles.Role private _distributor;
event distributorAdded(address amount);
event distributorRemoved(address amount);
 
constructor(address distributor){
 _addDistributor(distributor);
 
}
 
function _addDistributor(address amount) internal {
 _distributor.add(amount);
 emit distributorAdded(amount);
}
 
function _removeDistributor(address amount) internal {
 _distributor.remove(amount);
 emit distributorRemoved(amount);
}
 
function isDistributor(address amount) public view returns (bool){
 return _distributor.has(amount);
} 
 
modifier onlyDistributor(){
 require(isDistributor(msg.sender),"you are not deployer");
 _;
}
 
function addDistributor(address amount) public onlyDistributor{
 _addDistributor(amount);
}
 
function removeDistributor() public {
 _removeDistributor(msg.sender);
} 
}
```
##### FoodInfoItem.sol

```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

contract FoodInfoItem{
 uint256[] _timestamp; //时间戳
 string[] _traceName; //交易名称
 address[] _traceAddress; //交易地址
 uint8[] _traceQuality; //交易食品名称
 string _name; //食品名称
 string _currentName; //当前交易名称
 address _currentAddress; //当前交易地址
 uint8 _currentQuality; //当前交易质量 0 优质 1 合格 2 不合格
 uint8 _status; //当前交易状态 0 生产 1 分销 2 销售
 address owner;
constructor(string memory name, string memory traceName, address traceAddress,uint8 quality) public {
 _timestamp.push(block.timestamp);
 _traceName.push(traceName);
 _traceAddress.push(traceAddress);
 _traceQuality.push(quality);
 _name = name;
 _currentName = traceName;
 _currentAddress = traceAddress;
 _currentQuality = quality;
 _status = 0;
 owner = msg.sender;
} 
 
function addFoodByDistributor(string memory traceName, address traceAddress,uint8 quality) public returns(bool) {
 require(_status == 0 ,"this is not status 0");
 _timestamp.push(block.timestamp);
 _traceName.push(traceName);
 _traceAddress.push(traceAddress);
 _traceQuality.push(quality);
 _currentName = traceName;
 _currentAddress = traceAddress;
 _currentQuality = quality;
 _status = 1;
 return true;
}
 
function addFoodByRetailer(string memory traceName, address traceAddress,uint8 quality) public returns(bool){
 require(_status == 1 ,"this is not status 0");
 _timestamp.push(block.timestamp);
 _traceName.push(traceName);
 _traceAddress.push(traceAddress);
 _traceQuality.push(quality);
 _currentName = traceName;
 _currentAddress = traceAddress;
 _currentQuality = quality;
 _status = 2;
 return true;
}
 
//返回食品的信息
function getFoodInfo() public view returns (uint256,string memory,string memory,uint8,address,uint8){
 return (block.timestamp,_name,_currentName,_currentQuality,_currentAddress,_status);
}
 
//返回新增食品的信息农场
function getFoodInfoNew() public view returns (uint256,string memory,string memory,address,uint8){
 return (block.timestamp,_name,_traceName[0],_traceAddress[0],_traceQuality[0]);
}
 
//返回通过分销商的信息
function getFoodInfoByDistributor() public view returns (uint256,string memory,string memory,string memory,address,uint8){
 return (block.timestamp,_name,_traceName[0],_traceName[1],_traceAddress[1], _traceQuality[1]);
}
 
//返回通过零售商的信息
function getFoodInfoByRetailer() public view returns (uint256,string memory, string memory,string memory,string memory, address,uint8){
 return (_timestamp[0],_name,_traceName[0],_traceName[1],_traceName[2],_traceAddress[2],_traceQuality[2]);
}
 
function getFoodInfoByRoles() public view returns (uint256,address[] memory,uint8[] memory){
 return (_timestamp[0],_traceAddress,_traceQuality);
}
 
function getFoodInfoByAll() public view returns (string memory,uint256,string memory,uint8,uint256,string memory,uint8,uint256,string memory,uint8){
 return (_name,_timestamp[0],_traceName[0],_traceQuality[0],_timestamp[1],_traceName[1],_traceQuality[1],_timestamp[2],_traceName[2],_traceQuality[2]);
}
}
```
##### Trace.sol

```js
// SPDX-License-Identifier: MIT
pragma solidity ^0.4.25;

import "./Roles.sol";
import "./Producer.sol";
import "./Distributor.sol";
import "./Retailer.sol";
import "./FoodInfoItem.sol";

contract Trace is Producer,Distributor,Retailer{
 mapping (uint256 => address) foods;
 uint256[] foodlist;
 address public owner;
constructor(address producer,address distributor,address retailer) public Producer(address(0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3)) 
Distributor(address(0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3)) Retailer(address(0x64fa644d2a694681bd6addd6c5e36cccd8dcdde3)){
 owner = msg.sender;
}
 
function newFood(uint256 traceNumber,string memory name,string memory traceName, uint8 quality) public onlyProducer returns (FoodInfoItem){
 require(foods[traceNumber]==address(0),"address is not exist");
 FoodInfoItem food = new FoodInfoItem(name,traceName,msg.sender,quality);
 foods[traceNumber] = address(food);
 foodlist.push(traceNumber);
 return food;
}
 
function addFoodByDistributor(uint256 traceNumber,string memory traceName,uint8 quality) public onlyDistributor returns (bool){
 require(foods[traceNumber] != address(0),"address is 0");
 return FoodInfoItem(foods[traceNumber]).addFoodByDistributor(traceName,msg.sender, quality);
}
 
function addFoodByRetailer(uint256 traceNumber, string memory traceName, uint8 quality) public onlyRetailer returns (bool){
 require(foods[traceNumber] != address(0),"address is 0");
 return FoodInfoItem(foods[traceNumber]).addFoodByRetailer(traceName, msg.sender, quality);
}
 
//当前食品溯源
function getFoodInfo(uint256 traceNumber) public view returns (uint256,string memory,string memory,uint8,address,uint8){
 return FoodInfoItem(foods[traceNumber]).getFoodInfo();
}
 
//农场溯源
function getFoodInfoByNew(uint256 traceNumber) public view returns (uint256,string memory,string memory,address,uint8) {
 return FoodInfoItem(foods[traceNumber]).getFoodInfoNew();
}
 
//分销商溯源
function getFoodInfoByDistributor(uint256 traceNumber) public view returns (uint256,string memory,string memory,string memory,address,uint8) {
 return FoodInfoItem(foods[traceNumber]).getFoodInfoByDistributor();
}
 
//零售商溯源
function getFoodInfoRetailer(uint256 traceNumber) public view returns (uint256,string memory, string memory,string memory,string memory, address,uint8) {
 return FoodInfoItem(foods[traceNumber]).getFoodInfoByRetailer();
}
 
//三个阶段溯源
function getFoodInfoByRoles(uint256 traceNumber) public view returns (uint256,address[] memory,uint8[] memory){
 return FoodInfoItem(foods[traceNumber]).getFoodInfoByRoles();
}
 
//消费者整体溯源
function getFoodInfoByAll(uint256 traceNumber) public view returns (string memory,uint256,string memory,uint8,uint256,string memory,uint8,uint256,string memory,uint8) {
 return FoodInfoItem(foods[traceNumber]).getFoodInfoByAll();
}
 
//获取所有商品
function getAllFood() public view returns (uint256[] memory){
 require(msg.sender == owner,"you are not deployer");
 return foodlist;
}
}
```
至此所有演示全部结束。
#### 下载
原题下载：[GZ036 区块链技术应用赛项赛题第1套](https://sumhyh.lanzouv.com/iBW922a9kehi) 
合约下载：[食品溯源合约](https://sumhyh.lanzouv.com/ia1xT2a9kswh)

GZ036 区块链技术应用赛项赛题第1套(模块二)

# 企业级运维部署工具建链
`one_click_generator.sh`脚本为根据用户填写的节点配置，一键部署联盟链的脚本。脚本会根据用户指定文件夹下配置的node_deployment.ini，在文件夹下生成相应的节点。

本章主要以部署**3机构2群组6节点**的组网模式，为用户讲解单机构一键部署运维部署工具的使用方法。

本教程适用于单机构搭建所有节点的部署方式，运维部署工具多机构部署教程可以参考使用运维部署工具。

:::warning{title="注意"}
一键部署脚本使用时需要确保当前meta文件夹下不含节点证书信息，请清空meta文件夹。
:::



## 一、下载安装
**下载**

```shell
cd ~/ 
git clone https://github.com/FISCO-BCOS/generator.git

# 若因为网络问题导致长时间无法下载，请尝试以下命令：
git clone https://gitee.com/FISCO-BCOS/generator.git
```
**安装**

此操作要求用户具有sudo权限。

```shell
cd ~/generator && bash ./scripts/install.sh
```
检查是否安装成功，若成功，输出 usage: generator xxx

```shell
./generator -h
```
**获取节点二进制**

拉取最新fisco-bcos二进制文件到meta中，如果网络较差，可以尝试通过其他方式下载fisco-bcos，或使用`--cdn`选项，并将下载好的二进制放置于meta文件夹下


```shell
./generator --download_fisco ./meta
```
**检查二进制版本**


若成功，输出 FISCO-BCOS Version : x.x.x-x

```shell
./meta/fisco-bcos -v
```
PS：源码编译节点二进制的用户，只需要用编译出来的二进制替换掉meta文件夹下的二进制即可。
## 背景介绍

本节以部署6节点3机构2群组的组网模式，演示如何使用运维部署工具一键部署功能，搭建区块链。

### 1.节点组网拓扑结构

一个如图所示的6节点3机构2群组的组网模式。机构B和机构C分别位于群组1和群组2中。机构A同属于群组1和群组2中。

![image.png](/static/img/ea1576332e8938d6525eaf770b6b54b9.image.webp)
### 2.机器环境

| 机构 | 节点 | 所属群组 | P2P地址 | RPC | Channel监听地址 |
| --- | --- | --- | --- | --- | ---|
| 机构A | 节点0 | 群组1、2|127.0.0.1:30300|127.0.0.1:8545|0.0.0.0:20200|
||节点1|群组1、2|127.0.0.1:30301|127.0.0.1:8546|0.0.0.0:20201|
||节点4|群组1、2|127.0.0.1:30304|127.0.0.1:8549|0.0.0.0:20202|
|机构B|节点2|群组1|127.0.0.1:30302|127.0.0.1:8547|0.0.0.0:20203|
||节点3|群组1|127.0.0.1:30303|127.0.0.1:8548|0.0.0.0:20204|
|机构C|节点5|群组1、2|127.0.0.1:30305|127.0.0.1:8550|0.0.0.0:20205|



:::info{title="相关信息"}
- 云主机的公网IP均为虚拟IP，若rpc_ip/p2p_ip/channel_ip填写外网IP，会绑定失败，须填写0.0.0.0

- RPC/P2P/Channel监听端口必须位于1024-65535范围内，且不能与机器上其他应用监听端口冲突

- 出于安全性和易用性考虑，FISCO BCOS v2.3.0版本最新节点config.ini配置将listen_ip拆分成jsonrpc_listen_ip和channel_listen_ip，但仍保留对listen_ip的解析功能，详细请参考 这里

- 为便于开发和体验，channel_listen_ip参考配置是 0.0.0.0 ，出于安全考虑，请根据实际业务网络情况，修改为安全的监听地址，如：内网IP或特定的外网IP
:::
### 3.部署网络
首先完成如图所示机构A、B搭建群组1的操作：

![image.png](/static/img/c41963e133719dafd0194ecab822b1b0.image.webp)

使用前用户需准备如图如`tmp_one_click`的文件夹，在文件夹下分别拥有不同机构的目录，每个机构目录下需要有对应的配置文件node_deployment.ini。使用前需要保证generator的meta文件夹没有进行过任何操作。

查看一键部署模板文件夹：

```shell
cd ~/generator
ls ./tmp_one_click
```


:::tip{title="提示"}
参数解释
如需多个机构，需要手动创建该文件夹
tmp_one_click # 用户指定进行一键部署操作的文件夹
├── agencyA # 机构A目录，命令执行后会在该目录下生成机构A的节点及相关文件
│ └── node_deployment.ini # 机构A节点配置文件，一键部署命令会根据该文件生成相应节点
└── agencyB # 机构B目录，命令执行后会在该目录下生成机构B的节点及相关文件
 └── node_deployment.ini # 机构B节点配置文件，一键部署命令会根据该文件生成相应节点
:::
### 4.机构填写节点信息
教程中将配置文件放置与tmp_one_click文件夹下的agencyA, agencyB下

```shell
cat > ./tmp_one_click/agencyA/node_deployment.ini << EOF
[group]
group_id=1

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30300
channel_listen_port=20200
jsonrpc_listen_port=8545

[node1]
p2p_ip=127.0.0.1
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30301
channel_listen_port=20201
jsonrpc_listen_port=8546
EOF
```
### 5.生成节点

```shell
bash ./one_click_generator.sh -b ./tmp_one_click
```
执行完毕后，./tmp_one_click文件夹结构如下：

查看执行后的一键部署模板文件夹：

```shell
ls ./tmp_one_click
```

:::tip{title="提示"}
├── agencyA # A机构文件夹
│ ├── agency_cert # A机构证书及私钥
│ ├── generator-agency # 自动代替A机构进行操作的generator文件夹
│ ├── node # A机构生成的节点，多机部署时推送至对应服务器即可
│ ├── node_deployment.ini # A机构的节点配置信息
│ └── sdk # A机构的sdk或控制台配置文件
├── agencyB
| ├── agency_cert
| ├── generator-agency
| ├── node
| ├── node_deployment.ini
| └── sdk
|── ca.crt # 链证书
|── ca.key # 链私钥
|── group.1.genesis # 群组1创世区块
|── peers.txt # 节点的peers.txt信息
:::
### 6.启动节点
调用脚本启动节点：

```shell
bash ./tmp_one_click/agencyA/node/start_all.sh
bash ./tmp_one_click/agencyB/node/start_all.sh
```
查看节点进程：

```shell
ps -ef | grep fisco
```
### 7.查看节点运行状态
查看节点log：

```shell
tail -f ~/generator/tmp_one_click/agency*/node/node*/log/log* | grep +++
```

```shell
# 命令解释
# +++即为节点正常共识
info|2024-04-20 18:17:33.586835|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=1,hash=e508ebe9...
info|2024-04-20 18:17:34.590705|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=2,hash=fbba2141...
info|2024-04-20 18:17:35.598690|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=3,hash=23c1b21c...
```
## 二、新增节点 (扩容新节点)


:::warning{title="注意"}
一键部署脚本使用时需要确保当前meta文件夹下不含节点证书信息，请清空meta文件夹。
:::
接下来，我们为机构A和机构C增加新节点，完成下图所示的组网：

![image.png](/static/img/2ec007626b40448a98e01e0d90fff2d1.image.webp)
### 1.初始化扩容配置

创建扩容文件夹，示例中tmp_one_click_expand可以为任意名称，请每次扩容使用新的文件夹


```shell
mkdir ~/generator/tmp_one_click_expand/
```
### 2.拷贝链证书及私钥至扩容文件夹

```shell
cp ~/generator/tmp_one_click/ca.* ~/generator/tmp_one_click_expand/
```
拷贝群组1创世区块`group.1.genesis`至扩容文件夹

```shell
cp ~/generator/tmp_one_click/group.1.genesis ~/generator/tmp_one_click_expand/
```
拷贝群组1节点P2P连接文件`peers.txt`至扩容文件夹

```shell
cp ~/generator/tmp_one_click/peers.txt ~/generator/tmp_one_click_expand/
```
### 3.机构A配置节点信息
创建机构A扩容节点所在目录

```shell
mkdir ~/generator/tmp_one_click_expand/agencyA
```
此时机构A已经存在联盟链中，因此需拷贝机构A证书、私钥至对应文件夹

```shell
cp -r ~/generator/tmp_one_click/agencyA/agency_cert ~/generator/tmp_one_click_expand/agencyA
```
机构A填写节点配置信息

```shell
cat > ./tmp_one_click_expand/agencyA/node_deployment.ini << EOF
[group]
group_id=1

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30304
channel_listen_port=20204
jsonrpc_listen_port=8549
EOF
```
### 4.机构C配置节点信息
创建机构C扩容节点所在目录

```shell
mkdir ~/generator/tmp_one_click_expand/agencyC
```
机构C填写节点配置信息

```shell
cat > ./tmp_one_click_expand/agencyC/node_deployment.ini << EOF
[group]
group_id=1

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30305
channel_listen_port=20205
jsonrpc_listen_port=8550
EOF
```
### 5.生成扩容节点

```shell
bash ./one_click_generator.sh -e ./tmp_one_click_expand
```
### 6.启动新节点
调用脚本启动节点：

```shell
bash ./tmp_one_click_expand/agencyA/node/start_all.sh
bash ./tmp_one_click_expand/agencyC/node/start_all.sh
```
查看节点进程：

```shell
ps -ef | grep fisco
```

```shell
# 命令解释
# 可以看到如下进程
fisco-b+ 5560 1 0 18:36 pts/0 00:00:01 /home/fisco-bcos/generator/tmp_one_click_expand/agencyC/node/node_127.0.0.1_30305/fisco-bcos -c config.ini
fisco-b+ 5679 1 0 18:36 pts/0 00:00:01 /home/fisco-bcos/generator/tmp_one_click_expand/agencyA/node/node_127.0.0.1_30304/fisco-bcos -c config.ini
fisco-b+ 5874 1 1 18:39 pts/0 00:00:00 /home/fisco-bcos/generator/tmp_one_click/agencyA/node/node_127.0.0.1_30301/fisco-bcos -c config.ini
fisco-b+ 5876 1 1 18:39 pts/0 00:00:00 /home/fisco-bcos/generator/tmp_one_click/agencyA/node/node_127.0.0.1_30300/fisco-bcos -c config.ini
fisco-b+ 6106 1 1 18:39 pts/0 00:00:00 /home/fisco-bcos/generator/tmp_one_click/agencyB/node/node_127.0.0.1_30302/fisco-bcos -c config.ini
fisco-b+ 6108 1 1 18:39 pts/0 00:00:00 /home/fisco-bcos/generator/tmp_one_click/agencyB/node/node_127.0.0.1_30303/fisco-bcos -c config.ini

```

:::warning{title="注意"}
为群组1扩容的新节点需要使用sdk或控制台加入到群组中。
:::

### 7.使用控制台注册节点
由于控制台体积较大，一键部署中没有直接集成，用户可以使用以下命令获取控制台

:::info{title="相关信息"}
企业部署工具会根据generator/meta文件夹下的机构证书及私钥生成sdk相应证书，如需手动生成可以参考操作手册中的generate_sdk_certificate命令
:::

获取控制台，可能需要较长时间，国内用户可以使用`--cdn`命令：

以机构A使用控制台为例，此步需要切换到机构A对应的`generator-agency`文件夹


```shell
cd ~/generator/tmp_one_click/agencyA/generator-agency
./generator --download_console ./ --cdn
```
### 8.查看机构A节点4
机构A使用控制台加入机构A节点4为共识节点，其中参数第二项需要替换为加入节点的nodeid，nodeid在节点文件夹的conf的`node.nodeid`文件

查看机构A节点nodeid：

```shell
cat ~/generator/tmp_one_click_expand/agencyA/node/node_127.0.0.1_30304/conf/node.nodeid
```

```shell
# 命令解释
# 可以看到类似于如下nodeid，控制台使用时需要传入该参数
dae28f7392cbc9faf56ae889a32021d527c9ec2fd398a5c03ff30fdd00afa6138581a2e18808fa9a122a31defc5863fea7d2b4f248c874b4c4ce0c5b178a5817
```

企业级运维部署工具建链 

# FISCO BCOS Doker搭建
此篇演示为Doker Fisco Bcos搭建方式
build_chain.sh脚本提供-d参数，支持使用docker方式部署区块链。本章将演示如何以docker方式搭建四节点的区块链，通过示例帮助用户熟悉docker搭建区块链的流程。

:::info{title="相关信息"}
目前只支持在Linux环境通过docker方式部署区块链环境
:::
## 一、安装依赖
安装curl、openssl:

```shell
sudo apt install -y curl openssl
```
安装docker：
参考docker[官方文档](https://docs.docker.com/engine/install/)



## 二、下载安装脚本

```shell
## 创建操作目录
cd ~ && mkdir -p fisco && cd fisco

## 下载脚本
curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.9.1/build_chain.sh && chmod u+x build_chain.sh
```

:::info{title="相关信息"}
如果因为网络问题导致长时间无法下载build_chain.sh脚本，请尝试 curl -#LO https://gitee.com/FISCO-BCOS/FISCO-BCOS/raw/master-2.0/tools/build_chain.sh && chmod u+x build_chain.sh
:::
## 三、搭建单群组4节点区块链

```shell
在fisco目录下执行下面的指令，生成一条单群组4节点的区块链。 请确保机器的30300~30303，20200~20203，8545~8548端口没有被占用，也可以通过-p参数指定其他端口。
```

```shell
bash build_chain.sh -d -l 127.0.0.1:4 -p 30300,20200,8545
```
命令执行成功会输出All completed。如果执行出错，请检查nodes/build.log文件中的错误信息。

```shell
fisco-bcos@fiscobcos:~/fisco$ bash build_chain.sh -d -l 127.0.0.1:4 -p 30300,20200,8545
==============================================================
Generating CA key...
==============================================================
Generating keys and certificates ...
Processing IP=127.0.0.1 Total=4 Agency=agency Groups=1
==============================================================
Generating configuration files ...
Processing IP=127.0.0.1 Total=4 Agency=agency Groups=1
==============================================================
[INFO] Docker tag : latest
[INFO] Start Port : 30300 20200 8545
[INFO] Server IP : 127.0.0.1:4
[INFO] Output Dir : /home/fisco-bcos/fisco/nodes
[INFO] CA Path : /home/fisco-bcos/fisco/nodes/cert/
[INFO] RSA channel : true
==============================================================
[INFO] Execute the download_console.sh script in directory named by IP to get FISCO-BCOS console.
e.g. bash /home/fisco-bcos/fisco/nodes/127.0.0.1/download_console.sh -f
==============================================================
[INFO] All completed. Files in /home/fisco-bcos/fisco/nodes
```
## 四、启动区块链

```shell
bash nodes/127.0.0.1/start_all.sh
```
启动时，会查找本地是否存在FISCO-BCOS对应版本的节点镜像，不存在则从docker hub下载。

```shell
$ bash nodes/127.0.0.1/start_all.sh
try to start node0
try to start node1
try to start node2
try to start node3
Unable to find image 'fiscoorg/fiscobcos:v2.7.2' locally # 本地镜像不存在
Unable to find image 'fiscoorg/fiscobcos:v2.7.2' locally
Unable to find image 'fiscoorg/fiscobcos:v2.7.2' locally
Unable to find image 'fiscoorg/fiscobcos:v2.7.2' locally
v2.7.2: Pulling from fiscoorg/fiscobcos # 下载镜像
d519e2592276: Pulling fs layer
d22d2dfcfa9c: Pulling fs layer
b3afe92c540b: Pulling fs layer
d0e4ee611225: Waiting
af59874f6897: Waiting
v2.7.2: Pulling from fiscoorg/fiscobcos
d519e2592276: Pulling fs layer
d22d2dfcfa9c: Pulling fs layer
b3afe92c540b: Pulling fs layer
d0e4ee611225: Waiting
af59874f6897: Waiting
v2.7.2: Pulling from fiscoorg/fiscobcos
d519e2592276: Pulling fs layer
Pull complete d519e2592276: Pull complete
 Extracting 162B/162B
Pull complete d22d2dfcfa9c: Pull complete
af59874f6897: Extracting 24.48MB/26.71MB
Pull complete b3afe92c540b: Pull complete
d519e2592276: Pull complete
Pull complete d0e4ee611225: Pull complete
b3afe92c540b: Pull complete
Pull complete af59874f6897: Pull complete
af59874f6897: Pull complete
Digest: sha256:7a4e4f60bafe8362b402e0f86245c9a840544845fc57007259d2e4b023da6149
Status: Downloaded newer image for fiscoorg/fiscobcos:v2.7.2
Digest: sha256:7a4e4f60bafe8362b402e0f86245c9a840544845fc57007259d2e4b023da6149
Status: Image is up to date for fiscoorg/fiscobcos:v2.7.2
Digest: sha256:7a4e4f60bafe8362b402e0f86245c9a840544845fc57007259d2e4b023da6149
Status: Image is up to date for fiscoorg/fiscobcos:v2.7.2
Digest: sha256:7a4e4f60bafe8362b402e0f86245c9a840544845fc57007259d2e4b023da6149
Status: Image is up to date for fiscoorg/fiscobcos:v2.7.2
8df0d79bf764cd5693e00bbf5c91e2ed7ec69901049e79049082d7ab0da707c8 # 启动节点的 CONTAINER ID
c27dcaa0adfbf45820506f659913e6dacb8a148425801ea80ab078100a8d57b7 # 启动节点的 CONTAINER ID
e66fe7c68d3a8db5d8c18fe5749eba25fd41350ebbaa7accbc8374e03bfba690 # 启动节点的 CONTAINER ID
2bb7b89e2a46b9a4f92fbf9b48b39023540fccdae14de52e091fa17ea219905e # 启动节点的 CONTAINER ID
 node0 start successfully 
 node2 start successfully 
 node3 start successfully 
 node1 start successfully 
```

:::warning{title="注意"}
如果出现Docker出现报错，请尝试用root用户运行此命令
:::
## 五、检查容器

```shell
docker ps -a | egrep fiscobcos
```
会输出fiscobcos在运行的容器

```shell
8df0d79bf764 fiscoorg/fiscobcos:v2.7.2 "/usr/local/bin/fisc…" 5 minutes ago Up 5 minutes rootfisconodes127.0.0.1node2
2bb7b89e2a46 fiscoorg/fiscobcos:v2.7.2 "/usr/local/bin/fisc…" 5 minutes ago Up 5 minutes rootfisconodes127.0.0.1node1
e66fe7c68d3a fiscoorg/fiscobcos:v2.7.2 "/usr/local/bin/fisc…" 5 minutes ago Up 5 minutes rootfisconodes127.0.0.1node0
c27dcaa0adfb fiscoorg/fiscobcos:v2.7.2 "/usr/local/bin/fisc…" 5 minutes ago Up 5 minutes rootfisconodes127.0.0.1node3
```
容器状态为UP时，说明节点正常启动。 
docker的相关内容，可以参考docker文档进行了解: https://docs.docker.com/
## 六、 查看节点
可以通过检查日志来确认节点的p2p连接数目、共识是否正常。
- 查看节点node0连接的节点数

```shell
tail -f nodes/127.0.0.1/node0/log/log* | grep connected
```
正常情况会不停地输出连接信息，从输出可以看出node0与另外3个节点有连接。

```shell
info|2024-04-20 16:00:18.316769| [P2P][Service] heartBeat,connected count=3
info|2024-04-20 16:00:28.316922| [P2P][Service] heartBeat,connected count=3
info|2024-04-20 16:00:38.317105| [P2P][Service] heartBeat,connected count=3
```
- 检查共识

```shell
tril -f nodes/127.0.0.1/node0/log/log* | grep ++++
```
正常情况会不停输出`++++Generating seal`，表示共识正常。

```shell
info|2024-03-20 16:17:16.989389|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=2,hash=9af45b7d...
info|2024-03-20 16:17:21.003890|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=2,hash=427aae1b...
info|2024-04-20 16:17:25.023183|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generating seal on,blkNum=1,tx=0,nodeIdx=2,hash=a6c1a5a9...
```
到此docker环境已经部署完成。

区块链商店系统开发实操(设计流程图+区块链搭建+智能合约+后端)

一. 前置准备

GZ036 区块链技术应用赛项赛题第1套(模块一)

模块一区块链搭建部分

GZ036 区块链技术应用赛项赛题第1套(模块二)

模块二食品溯源智能合约部分

企业级运维部署工具建链

FISCO BCOS Doker搭建

一、安装依赖

区块链商店系统开发实操(设计流程图+区块链搭建+智能合约+后端)

一. 前置准备

GZ036 区块链技术应用赛项赛题第1套(模块一)

模块一 区块链搭建部分

GZ036 区块链技术应用赛项赛题第1套(模块二)

模块二 食品溯源智能合约部分

企业级运维部署工具建链

FISCO BCOS Doker搭建

一、安装依赖

模块一区块链搭建部分

模块二食品溯源智能合约部分