Appendix

Command Line Parameters

Table 1 login command parameters

Command

Parameter

Description

login

  

  

-H, --host

Specifies the iSulad socket file path to be accessed.

-p, --password

Specifies the password for logging in to the registry.

--password-stdin

Specifies the password for obtaining the registry from standard input.

-u, --username

Specifies the username for logging in to the registry.

Table 2 logout command parameters

Command

Parameter

Description

logout

-H, --host

Specifies the iSulad socket file path to be accessed.

Table 3 pull command parameters

Command

Parameter

Description

pull

-H, --host

Specifies the iSulad socket file path to be accessed.

Table 4 rmi command parameters

Command

Parameter

Description

rmi

  

-H, --host

Specifies the iSulad socket file path to be accessed.

-f, --force

Forcibly removes an image.

Table 5 load command parameters

Command

Parameter

Description

load

-H, --host (supported only by iSula)

Specifies the iSulad socket file path to be accessed.

-i, --input

Specifies where to import an image. If the image is of the docker type, the value is the image package path. If the image is of the embedded type, the value is the image manifest path.

--tag

Uses the image name specified by TAG instead of the default image name. This parameter is supported when the type is set to docker.

-t, --type

Specifies the image type. The value can be embedded or docker (default value).

Table 6 images command parameters

Command

Parameter

Description

images

  

-H, --host

Specifies the iSulad socket file path to be accessed.

-q, --quit

Displays only the image name.

Table 7 inspect command parameters

Command

Parameter

Description

inspect

-H, --host

Specifies the iSulad socket file path to be accessed.

-f, --format

Outputs using a template.

-t, --time

Timeout interval, in seconds. If the inspect command fails to query container information within the specified period, the system stops waiting and reports an error immediately. The default value is 120s. If the value is less than or equal to 0, the inspect command keeps waiting until the container information is obtained successfully.

CNI Parameters

Table 1 CNI single network parameters

Parameter

Type

Mandatory or Not

Description

cniVersion

string

Yes

CNI version. Only 0.3.0 and 0.3.1 are supported.

name

string

Yes

Network name, which is user-defined and must be unique.

type

string

Yes

Network type. The following types are supported:

underlay_ipvlan

overlay_l2

underlay_l2

vpc-router

dpdk-direct

phy-direct

ipmasp

bool

No

Configures the IP masquerade.

ipam

structure

No

For details, see the IPAM parameter definition.

ipam.type

string

No

IPAM type. The following types are supported:

(1) For underlay_l2, overlay_l2, and vpc-router networking, only the default value distributed_l2 is supported.

(2) For underlay_ipvlan networking, the default value is distributed_l2. In the CCN scenario, only null and fixed are supported. In the CCE and FST 5G core scenarios, only null and distributed_l2 are supported.

(3) For phy-direct and dpdk-direct networking, the default value is l2, and optional values are null and distributed_l2. In the FST 5G core scenario, only null and distributed_l2 are supported.

Description:

If the value is out of the range (for example, host-local), Canal automatically sets the value to the default value and no error is returned.

null: Canal is not used to manage IP addresses.

fixed: fixed IP address, which is used in the CCN scenario.

l2: This value is not used in any scenario.

distributed_l2: The distributed small subnet is used to manage IP addresses.

ipam.subnet

string

No

Subnet information. Canal supports the subnet mask ranging from 8 to 29. The IP address cannot be a multicast address (for example, 224.0.0.0/4), reserved address (240.0.0.0/4), local link address (169.254.0.0/16), or local loop address (127.0.0.0/8).

ipam.gateway

string

No

Gateway IP address.

ipam.range-start

string

No

Available start IP address.

ipam.range-end

string

No

Available end IP address.

ipam.routes

structure

No

Subnet list. Each element is a route dictionary. For details, see the route definition.

ipam.routes.dst

string

No

Destination network.

ipam.routes.gw

string

No

Gateway address.

dns

structure

No

Contains some special DNS values.

dns.nameservers

[]string

No

NameServers

dns.domain

string

No

Domain

dns.search

[]string

No

Search

dns.options

[]string

No

Options

multi_entry

int

No

Number of IP addresses required by a vNIC. The value ranges from 0 to 16. For physical passthrough, a maximum of 128 IP addresses can be applied for a single NIC.

backup_mode

bool

No

Active/Standby mode, which is used only for phy-direct and dpdk-direct networking.

vlanID

int

No

The value ranges from 0 to 4095. It can be specified through PaaS.

vlan_inside

bool

No

The value true indicates that the VLAN function is implemented internally on the node, and the value false indicates that the VLAN function is implemented externally.

vxlanID

int

No

The value ranges from 0 to 16777215. It can be specified through PaaS.

vxlan_inside

bool

No

The value true indicates that the VLAN function is implemented internally on the node, and the value false indicates that the VLAN function is implemented externally.

action

string

No

This parameter can be used only with the special container ID 000000000000.

Create: creates a network.

Delete: deletes a network.

args

map[string]interface{}

No

Key-value pair type.

runtimeConfig

structure

No

None

capabilities

structure

No

None

Table 2 CNI args parameters

Parameter

Type

Mandatory

Description

K8S_POD_NAME

string

No

Set this parameter when you apply for a fixed IP address (runtimeConfig.ican_caps.fixed_ip is set to true).

K8S_POD_NAMESPACE

string

No

Set this parameter when you apply for a fixed IP address (runtimeConfig.ican_caps.fixed_ip is set to true).

SECURE_CONTAINER

string

No

Secure container flag.

multi_port

int

No

The value ranges from 1 to 8. The default value is 1. Specifies the number of passthrough NICs. Only phy-direct and dpdk-direct networks are supported.

phy-direct

string

No

Specifies the NIC to be connected when you create an SR-IOV container network.

dpdk-direct

string

No

Specifies the NIC to be connected when you create a DPDK passthrough container network.

tenant_id

string

No

Indicates the tenant ID.

Only vpc-router networks are supported.

vpc_id

string

No

VPC ID.

Only vpc-router networks are supported.

secret_name

string

No

Specifies the AK/SK object name on the K8S APIServer.

Only vpc-router networks are supported.

For details, see the configuration of VPC-Router logical networks.

IP

string

No

IP address specified by the user, in the format of 192.168.0.10.

K8S_POD_NETWORK_ARGS

string

No

Specifies an IP address, in the format of 192.168.0.10. If both IP and K8S_POD_NETWORK_ARGS in args are not empty, the value of K8S_POD_NETWORK_ARGS prevails.

INSTANCE_NAME

string

No

INSTANCE ID.

Refer to fixed IP addresses that support containers.

dist_gateway_disable

bool

No

The value true indicates that no gateway is created, and the value false indicates that a gateway is created.

phynet

string or []string

No

Specifies the name of the physical plane to be added. The physical plane name is predefined and corresponds to that in the SNC system. When two plane names are entered, the active and standby planes are supported. Example: phy_net1 or ["phy_net2","phy_net3"]

endpoint_policies

struct

No

"endpoint_policies": [

{

"Type": "",

"ExceptionList": [

""

],

"NeedEncap": true,

"DestinationPrefix": ""

}

]

port_map

struct

No

On a NAT network, container ports can be advertised to host ports.

"port_map": [

{

"local_port": number,

"host_port": number,

"protocol": [string...]

}...

]

Table 3 CNI multiple network parameters

Parameter

Type

Mandatory

Description

cniVersion

string

Yes

CNI version. Only 0.3.0 and 0.3.1 are supported.

name

string

Yes

Network name, which is user-defined and must be unique.

plugins

struct

Yes

For details, see CNI single network parameters

有奖捉虫

“有虫”文档片段

存在的问题

提交类型 issue
有点复杂...
找人问问吧。
PR
小问题,全程线上修改...
一键搞定!
问题类型
规范和低错类

● 错别字或拼写错误;标点符号使用错误;

● 链接错误、空单元格、格式错误;

● 英文中包含中文字符;

● 界面和描述不一致,但不影响操作;

● 表述不通顺,但不影响理解;

● 版本号不匹配:如软件包名称、界面版本号;

易用性

● 关键步骤错误或缺失,无法指导用户完成任务;

● 缺少必要的前提条件、注意事项等;

● 图形、表格、文字等晦涩难懂;

● 逻辑不清晰,该分类、分项、分步骤的没有给出;

正确性

● 技术原理、功能、规格等描述和软件不一致,存在错误;

● 原理图、架构图等存在错误;

● 命令、命令参数等错误;

● 代码片段错误;

● 命令无法完成对应功能;

● 界面错误,无法指导操作;

风险提示

● 对重要数据或系统存在风险的操作,缺少安全提示;

内容合规

● 违反法律法规,涉及政治、领土主权等敏感词;

● 内容侵权;

您对文档的总体满意度

非常不满意
非常满意
创Issue赢奖品
根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。