Use the ZEDEDA CLI to Manage a Network

Introduction

A network handles routing for edge node hardware to pass traffic to and from ZEDEDA Cloud for management purposes, for example. This article explains how to manage a network using the ZEDEDA CLI, including creation, updates, and deletion commands, with examples for each action.

Prerequisites

ZCLI is running.

This is a series of articles. You will likely follow them in this order.

1. Network Overview
2. Create a Network
3. Manage a Network
4. Use the ZEDEDA CLI to Manage a Network - You are here!

Create a network

Create a network from the ZCLI.

zcli network create <name> --project=<project> --kind=[Portv4|Portv6] --dhcp=[client|server|static|passthrough] [--wifi-config=<file-path> | --cellular-config=<APN>] [--static-dns=<hostname:ip>...] [--subnet=<subnet-id>] [--gateway=<gateway>] [--domain=<domain>] [--nameserver=<dns>...] [--dhcp-range=<range>] [--title=title] [--description=<description>] [--proxy-network=on|off | --proxy-pacfile=<pacfilepath> | --proxy-static=<filepath> | --proxy-url=<pacfileurl>] [--proxy-certificate=<proxy-certificate>...]

zcli network create MY-NET --project=MY-PROJ --kind=Portv4 --dhcp=client

View a network

After you create networks, you can view them.

zcli network show

Update a network

After you create a network, you can update it whenever things change.

zcli network update <name> [--title=title] [--description=<description>] [--wifi-config=<file-path> | --cellular-config=<APN>] [--disable-proxy=[true|false] | --proxy-network=[on|off] | --proxy-pacfile=<pacfilepath> | --proxy-static=<filepath> | --proxy-url=<pacfileurl>] [--proxy-certificate=<proxy-certificate>...][--mtu=<mtu>]

zcli network update MY-NET –-disable-proxy=true

Delete a network

After you add a network, you can delete it if you no longer need it. If you don’t use the -f option, you’ll be prompted to confirm. 

zcli network delete <name> [-f]

zcli network delete MY-NET -f

Next steps

This is a series of articles. You will likely follow them in this order.

1. Network Overview
2. Create a Network
3. Manage a Network
4. Use the ZEDEDA CLI to Manage a Network - You are here!

After you’ve completed the series, you might be interested in the following articles. 

1. See Network Instances: a use case for an example of using adapter labels to implement multi-path routing with failover and port-forwarding restrictions.
2. Deploy the edge application instance on the edge node to instantiate the app.
3. Manage edge nodes and manage edge apps.