routes
Manage service routes
routes
Manage CIDR-based routing rules for services.
Aliases: route
Synopsis
arctic routes <subcommand> --service <service-id> [flags]Subcommands
| Subcommand | Description |
|---|---|
| list | List routes for a service |
| add | Add a route to a service |
| update | Update a route |
| delete | Delete a route |
list
List routes for a service.
Usage
arctic routes list --service <service-id>Flags
| Flag | Description |
|---|---|
--service | Service ID (required) |
Required Scope
urn:tillered:arctic:services.read
Example
arctic routes list --service svc_01HSVCABC123...Output
ID PRIORITY SOURCE CIDR DEST CIDR
6 100 10.0.0.0/8 192.168.100.0/24
7 200 10.1.0.0/16 192.168.200.0/24add
Add a route to a service.
Usage
arctic routes add --service <service-id> --priority <priority> [flags]Flags
| Flag | Description |
|---|---|
--service | Service ID (required) |
--priority | Route priority - higher = more preferred (required) |
--source-cidr | Source CIDR (e.g., 10.0.0.0/8) |
--dest-cidr | Destination CIDR (e.g., 192.168.100.0/24) |
Required Scope
urn:tillered:arctic:services.write
Examples
# Source and destination CIDR
arctic routes add --service svc_01HSVCABC123... \
--priority 100 \
--source-cidr 10.0.0.0/8 \
--dest-cidr 192.168.100.0/24
# Destination only
arctic routes add --service svc_01HSVCABC123... \
--priority 100 \
--dest-cidr 192.168.100.0/24
# Source only
arctic routes add --service svc_01HSVCABC123... \
--priority 100 \
--source-cidr 10.0.0.0/8Output
Route IDs: 6
Count: 1
Route added successfully: ID=6, Priority=100Errors
| Error | Description |
|---|---|
--service is required | Missing service flag |
--priority is required | Missing priority flag |
invalid CIDR notation | Malformed CIDR |
service not found | Service does not exist |
update
Update a route.
Usage
arctic routes update --service <service-id> --route <route-id> [flags]Flags
| Flag | Description |
|---|---|
--service | Service ID (required) |
--route | Route ID (required) |
--priority | New priority |
--source-cidr | New source CIDR |
--dest-cidr | New destination CIDR |
Required Scope
urn:tillered:arctic:services.write
Examples
# Update priority
arctic routes update --service svc_01HSVCABC123... --route 6 --priority 200
# Update CIDRs
arctic routes update --service svc_01HSVCABC123... --route 6 \
--source-cidr 10.1.0.0/16 \
--dest-cidr 192.168.200.0/24Output
Route updated successfully: ID=6Errors
| Error | Description |
|---|---|
--service is required | Missing service flag |
--route is required | Missing route flag |
invalid --route value: must be a number | Non-numeric route ID |
no fields to update | No update flags provided |
route not found | Route does not exist |
delete
Delete a route.
Usage
arctic routes delete --service <service-id> --route <route-id> [--yes]Flags
| Flag | Description |
|---|---|
--service | Service ID (required) |
--route | Route ID (required) |
--yes | Skip confirmation prompt |
Required Scope
urn:tillered:arctic:services.write
Examples
# Delete with confirmation
arctic routes delete --service svc_01HSVCABC123... --route 6
# Delete without confirmation
arctic routes delete --service svc_01HSVCABC123... --route 6 --yesOutput
Route deleted successfully: ID=6Route Priority
Routes are evaluated by specificity first, then priority:
- Specificity: More specific CIDRs (larger prefix) match first
- Priority: When specificity is equal, higher priority wins
Example evaluation order:
| Priority | Source CIDR | Dest CIDR | Order |
|---|---|---|---|
| 200 | 10.1.0.0/16 | 192.168.100.0/24 | 1st (most specific) |
| 100 | 10.0.0.0/8 | 192.168.100.0/24 | 2nd |
| 100 | 10.0.0.0/8 | 192.168.0.0/16 | 3rd (less specific dest) |
See Also
- Configure Routes - How-to guide
- services - Service management
- Routing Concepts