Search

vcli vclgroup

Handle VCLGroup

Synopsis

Handle VCLGroup such as listing, add, delete or update.

Examples:

	# List VCL Files
	vclgroups list

	# List with Filter
	vclgroups list -f name="*MyVCL*"

	# Raw API output for a VCLGroup
	vclgroups inspect 1

	# Create VCLGroups with tags and as root deployed
	vclgroups add MyVCLGroupName --tags id=1,2 --root

	# Create with multiple tag groups
	vclgroups add MyVCLGroupName --tags name=prod,eu --tags name=prod,us

	# Update VCLGroups
	vclgroups update 1 --name newName --root=false

	# Update to use a specific routing-rule
	vclgroups update 1 --rr 1

	# Clear routing-rule from an existing VCLGroup
	vclgroups update 1 --clear-rr

	# Deploy VCLGroup using Git
	vclgroups add test --tags id=1 --domains 1 --git-branch master --git-repo 1 --git-main main.vcl

	# Clear Git configuration from a VCLGroup
	vclgroups u 1 --clear-git

	# Delete VCLGroups
	vclgroups delete 1

	# Validate a VCLGroup placement with agents to make sure it doesn't
	# collide with other domains/VCLGroups that are deployed.
	vclgroups validate 1  --vcl 1:2 --root=true

	# Test compile a set of given files for a VCLGroup
	vclgroups compile 1 --vcl 1:latest --includes 2:latest

	# Deploy VCLGroups with main VCL and include files
	vclgroups deploy 1 --vcl 1:latest --includes 1:2

	# Deploy VCLGroup with last deployed files and wait max 60s
	vclgroups deploy 1 -w 60s

	# Deploy VCLGroup with last deployed files and wait max 60s and to at least 50% deployed.
	vclgroups deploy 1 -w 60s -p 50

	# Deploy the latest version of the main VCL to a VCLGroup without specifying all files.
	vclgroups deploy-files 1 --vcl 1:latest

	# Deploy specific file version to a VCLGroup without specifying all files and main VCL.
	vclgroups deploy-files 1 --includes 1:2

	# Remove a file from a VCLGroup and deploy.
	vclgroups deploy-files 1 --remove-includes 1

	# Rollback a VCLGroup to last deployed files
	vclgroups rollback 1

	# Rollback a VCLGroup to files in deploylog with ID 10
	vclgroups rollback 1 -l 10

	# List deploylogs
	vclgroups deploylogs 1

	# Delete deploylogs
	vclgroups deploylogs 1 -d 1,2

	# See statistics for VCLGroups
	vclgroups stats -v

	# Validate a routing-rule with a VCLGroup
	vclgroups rr-validate 1 --r 1

	# Show current deploy state for a VCLGroup on all agents
	vclgroups state 1

	# See current compile status for a deployment (or last deployment)
	vclgroups deploy-status 1

Options

  -h, --help   help for vclgroup

Options inherited from parent commands

  -c, --config string   configuration file for the CLI (default ~/.vcli.yml)
                        Could also be set via VARNISH_CONTROLLER_CLI_CONFIG=/path/to/config.yml
      --csv             Output the response table as CSV format.
  -j, --json            Output the response table as JSON format.

SEE ALSO


®Varnish Software, Wallingatan 12, 111 60 Stockholm, Organization nr. 556805-6203