uffizzi-cli 1.0.4 → 2.0.29

data/man/uffizzi-cluster-list

@@ -0,0 +1,34 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-CLUSTER\-LIST" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-cluster\-list\fR \- list clusters in a project
+.SH "SYNOPSIS"
+.nf
+uffizzi cluster list [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Lists all clusters for a project, including active,
+deploying and failed clusters\.
+
+For more information on Uffizzi clusters, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "FLAGS"
+.nf
+\-\-output=pretty\-json
+\-\-output=json
+    Use this option for formatting output\.
+.fi
+.SH "EXAMPLES"
+.nf
+To list all clusters, run:
+
+    $ uffizzi cluster list
+
+To list all clusters in json format, run:
+
+    $ uffizzi cluster list \-\-output="pretty\-json"
+.fi
+

data/man/uffizzi-cluster-list.ronn

@@ -0,0 +1,26 @@
+uffizzi-cluster-list - list clusters in a project
+================================================================
+
+## SYNOPSIS
+    uffizzi cluster list [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Lists all clusters for a project, including active,
+    deploying and failed clusters.
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## FLAGS
+    --output=pretty-json
+    --output=json
+        Use this option for formatting output.
+
+## EXAMPLES
+    To list all clusters, run:
+
+        $ uffizzi cluster list
+
+    To list all clusters in json format, run:
+
+        $ uffizzi cluster list --output="pretty-json"

data/man/uffizzi-cluster-update-kubeconfig

@@ -0,0 +1,37 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-CLUSTER\-UPDATE\-KUBECONFIG" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-cluster\-update\-kubeconfig\fR \- update a kubeconfig
+.SH "SYNOPSIS"
+.nf
+uffizzi cluster update\-kubeconfig [CLUSTER_NAME]
+.fi
+.SH "DESCRIPTION"
+.nf
+Update your kubeconfig file\.
+
+This command can fail for the following reasons:
+    \- Your kubeconfig file out of specification
+
+For more information on Uffizzi clusters, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "FLAGS"
+.nf
+\-\-kubeconfig="/path/to/your/kubeconfig"
+    Path to kubeconfig file you want to update
+
+\-\-print
+    Print kubeconfig to STDOUT without updating kubeconfig file\.
+
+\-\-quiet
+    Quiet mode
+.fi
+.SH "EXAMPLES"
+.nf
+To update kubeconfig file, run:
+
+    $ uffizzi cluster update\-kubeconfig \-\-kubeconfig="/file/path/to/kubeconfig"
+.fi
+

data/man/uffizzi-cluster-update-kubeconfig.ronn

@@ -0,0 +1,29 @@
+uffizzi-cluster-update-kubeconfig - update a kubeconfig
+================================================================
+
+## SYNOPSIS
+    uffizzi cluster update-kubeconfig [CLUSTER_NAME]
+
+## DESCRIPTION
+    Update your kubeconfig file.
+
+    This command can fail for the following reasons:
+        - Your kubeconfig file out of specification
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## FLAGS
+    --kubeconfig="/path/to/your/kubeconfig"
+        Path to kubeconfig file you want to update
+
+    --print
+        Print kubeconfig to STDOUT without updating kubeconfig file.
+
+    --quiet
+        Quiet mode
+
+## EXAMPLES
+    To update kubeconfig file, run:
+
+        $ uffizzi cluster update-kubeconfig --kubeconfig="/file/path/to/kubeconfig"

data/man/uffizzi-cluster.ronn

@@ -0,0 +1,32 @@
+uffizzi-cluster - manage clusters
+================================================================
+
+## SYNOPSIS
+    uffizzi cluster COMMAND
+
+## DESCRIPTION
+    Manage Uffizzi clusters
+
+    For more information on Uffizzi clusters, see:
+    https://docs.uffizzi.com/references/cli/
+
+## COMMANDS
+    COMMAND is one of the following:
+
+     create
+        Create a cluster
+
+     delete
+        Delete a cluster
+
+     describe
+        Display details of a cluster
+
+     list
+        List all clusters
+
+     update-kubeconfig
+        Update kubeconfig file
+
+##
+Run 'uffizzi cluster COMMAND --help' for more information on a command.

data/man/uffizzi-compose

@@ -0,0 +1,39 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\fR \- manage previews
+.SH "SYNOPSIS"
+.nf
+uffizzi compose COMMAND [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Manage Uffizzi previews
+
+For more information on Uffizzi previews, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "COMMANDS"
+.nf
+COMMAND is one of the following:
+
+ create
+    Create a compose environment (preview)
+
+ delete
+    Delete a compose environment (preview)
+
+ describe
+    Display details of a compose environment (preview)
+
+ list
+    List all compose environments (previews)
+.fi
+.SH "Run \'uffizzi compose COMMAND \-\-help\' for more information on a command\."
+

data/man/uffizzi-compose-create

@@ -0,0 +1,67 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-CREATE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-create\fR \- create a compose environment (preview)
+.SH "SYNOPSIS"
+.nf
+uffizzi compose create [COMPOSE_FILE] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Creates a new compose environment (preview)\. If no COMPOSE_FILE is specified,
+the compose environment (preview) is created with the project\'s default compose file\.
+Run $ uffizzi project compose \-\-help for details\.
+
+This command can fail for the following reasons:
+    \- The project does not have a default compose file set\. Run
+      $ uffizzi compose \-\-help for details\.
+    \- The alternate compose file is invalid\.
+
+For more information on Uffizzi previews, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[COMPOSE_FILE]
+    An alternate compose file to the default compose\.
+
+    You can pass a compose file to this command to create an ad hoc
+    compose environment (preview) of an alternate compose configuration\.
+    The file passed via this argument does not replace the default
+    compose file for the project\. Alternate compose files share the
+    same lifecyle as the previews they create: when the compose
+    environment (preview) is deleted, the alternate compose
+    is deleted by the Uffizzi API\.
+.fi
+.SH "FLAGS"
+.nf
+\-\-set\-labels=METADATA
+    Metadata of deployment that contains any information which can
+    be useful for filtering deployments\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+To create a compose environment (preview) with the project\'s default compose file, run:
+
+    $ uffizzi compose create
+
+To create a compose environment (preview) with an alternate compose file, run:
+
+    $ uffizzi compose create docker\-compose\.uffizzi\.alt\.yml
+
+To create a compose environment (preview) with single label, run:
+
+    $ uffizzi compose create \-\-set\-labels github\.repo=my_repo
+
+To create a compose environment (preview) with multiple labels, run:
+
+    $ uffizzi compose create \e
+    \-\-set\-labels="github\.repo=my_repo github\.pull_request\.number=23"
+.fi
+

data/man/uffizzi-compose-create.ronn

@@ -0,0 +1,57 @@
+uffizzi-compose-create - create a compose environment (preview)
+================================================================
+
+## SYNOPSIS
+    uffizzi compose create [COMPOSE_FILE] [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Creates a new compose environment (preview). If no COMPOSE_FILE is specified,
+    the compose environment (preview) is created with the project's default compose file.
+    Run $ uffizzi project compose --help for details.
+
+    This command can fail for the following reasons:
+        - The project does not have a default compose file set. Run
+          $ uffizzi compose --help for details.
+        - The alternate compose file is invalid.
+
+    For more information on Uffizzi previews, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [COMPOSE_FILE]
+        An alternate compose file to the default compose.
+
+        You can pass a compose file to this command to create an ad hoc
+        compose environment (preview) of an alternate compose configuration.
+        The file passed via this argument does not replace the default
+        compose file for the project. Alternate compose files share the
+        same lifecyle as the previews they create: when the compose
+        environment (preview) is deleted, the alternate compose
+        is deleted by the Uffizzi API.
+
+## FLAGS
+    --set-labels=METADATA
+        Metadata of deployment that contains any information which can
+        be useful for filtering deployments.
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## EXAMPLES
+    To create a compose environment (preview) with the project's default compose file, run:
+
+        $ uffizzi compose create
+
+    To create a compose environment (preview) with an alternate compose file, run:
+
+        $ uffizzi compose create docker-compose.uffizzi.alt.yml
+
+    To create a compose environment (preview) with single label, run:
+
+        $ uffizzi compose create --set-labels github.repo=my_repo
+
+    To create a compose environment (preview) with multiple labels, run:
+
+        $ uffizzi compose create \
+        --set-labels="github.repo=my_repo github.pull_request.number=23"

data/man/uffizzi-compose-delete

@@ -0,0 +1,38 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-DELETE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-delete\fR \- delete a compose environment (preview)
+.SH "SYNOPSIS"
+.nf
+uffizzi compose delete [PREVIEW_ID] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Deletes a compose environment (preview) with
+the given compose environment (preview) ID\.
+
+This command can fail for the following reasons:
+    \- The compose environment (preview) specified does not exist\.
+    \- The compose environment (preview) specified belongs to a different project\.
+
+For more information on Uffizzi previews, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[PREVIEW_ID]
+    ID for the compose environment (preview) you want to delete\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+The following command deletes the compose environment (preview) with ID deployment\-213:
+
+    $ uffizzi compose delete deployment\-213
+.fi
+

data/man/uffizzi-compose-delete.ronn

@@ -0,0 +1,29 @@
+uffizzi-compose-delete - delete a compose environment (preview)
+================================================================
+
+## SYNOPSIS
+    uffizzi compose delete [PREVIEW_ID] [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Deletes a compose environment (preview) with
+    the given compose environment (preview) ID.
+
+    This command can fail for the following reasons:
+        - The compose environment (preview) specified does not exist.
+        - The compose environment (preview) specified belongs to a different project.
+
+    For more information on Uffizzi previews, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [PREVIEW_ID]
+        ID for the compose environment (preview) you want to delete.
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## EXAMPLES
+    The following command deletes the compose environment (preview) with ID deployment-213:
+
+        $ uffizzi compose delete deployment-213

data/man/uffizzi-compose-describe

@@ -0,0 +1,38 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-DESCRIBE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-describe\fR \- show metadata for a compose environment (preview)
+.SH "SYNOPSIS"
+.nf
+uffizzi compose describe [PREVIEW_ID] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Shows metadata for a project given a valid compose environment (preview) ID\.
+
+This command can fail for the following reasons:
+    \- The compose environment (preview) specified does not exist\.
+    \- The compose environment (preview) specified belongs to a different project\.
+
+For more information on Uffizzi previews, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[PREVIEW_ID]
+    ID for the compose environment (preview) you want to describe\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+The following command prints metadata for the compose environment (preview) with ID
+deployment\-213:
+
+    $ uffizzi compose describe deployment\-213
+.fi
+

data/man/uffizzi-compose-describe.ronn

@@ -0,0 +1,29 @@
+uffizzi-compose-describe - show metadata for a compose environment (preview)
+================================================================
+
+## SYNOPSIS
+    uffizzi compose describe [PREVIEW_ID] [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Shows metadata for a project given a valid compose environment (preview) ID.
+
+    This command can fail for the following reasons:
+        - The compose environment (preview) specified does not exist.
+        - The compose environment (preview) specified belongs to a different project.
+
+    For more information on Uffizzi previews, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [PREVIEW_ID]
+        ID for the compose environment (preview) you want to describe.
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## EXAMPLES
+    The following command prints metadata for the compose environment (preview) with ID
+    deployment-213:
+
+        $ uffizzi compose describe deployment-213

data/man/uffizzi-compose-events

@@ -0,0 +1,38 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-EVENTS" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-events\fR \- show the deployment event logs for a compose environment (preview)
+.SH "SYNOPSIS"
+.nf
+uffizzi compose events [COMPOSE_ENVIRONMENT_ID] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Shows the deployment event logs for a given compose environment (preview)\.
+
+This command can fail for the following reasons:
+    \- There is no compose environment (preview) with
+      the given compose environment (preview) ID
+
+For more information on event logs, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[COMPOSE_ENVIRONMENT_ID]
+    The ID of the compose environment (preview) that you want to see events for\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+The following command shows deployment events for
+the compose environment (preview) with ID deployment\-67:
+
+    $ uffizzi compose events deployment\-67
+.fi
+

data/man/uffizzi-compose-events.ronn

@@ -0,0 +1,29 @@
+uffizzi-compose-events - show the deployment event logs for a compose environment (preview)
+================================================================
+
+## SYNOPSIS
+    uffizzi compose events [COMPOSE_ENVIRONMENT_ID] [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Shows the deployment event logs for a given compose environment (preview).
+
+    This command can fail for the following reasons:
+        - There is no compose environment (preview) with
+          the given compose environment (preview) ID
+
+    For more information on event logs, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [COMPOSE_ENVIRONMENT_ID]
+        The ID of the compose environment (preview) that you want to see events for.
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## EXAMPLES
+    The following command shows deployment events for
+    the compose environment (preview) with ID deployment-67:
+
+        $ uffizzi compose events deployment-67

data/man/uffizzi-compose-list

@@ -0,0 +1,58 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-LIST" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-list\fR \- list compose environments (previews) in a project
+.SH "SYNOPSIS"
+.nf
+uffizzi compose list [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Lists all compose environments (previews) for a project,
+including active, building, deploying and failed compose
+environments (previews)\.
+
+For more information on Uffizzi compose environments (previews), see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "FLAGS"
+.nf
+\-\-filter=METADATA
+    Metadata to filter list of deployments\.
+
+\-\-output=pretty\-json
+    Use this option for a more detailed description of listed
+    deployments\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+To list all compose environments (previews) in the default project, run:
+
+    $ uffizzi compose list
+
+To list all compose environments (previews) in a project with name my_project, run:
+
+    $ uffizzi compose list \-\-project="my_project"
+
+To list all compose environments (previews) in json format, run:
+
+    $ uffizzi compose list \-\-output="pretty\-json"
+
+To list all compose environments (previews) filtered by metadata using single
+label, run:
+
+    $ uffizzi compose list \-\-filter github\.repo=my_repo
+
+To list all compose environments (previews) filtered by metadata using multiple
+labels, run:
+
+    $ uffizzi compose list \e
+    \-\-filter="github\.repo=my_repo github\.pull_request\.number=23"
+.fi
+

data/man/uffizzi-compose-list.ronn

@@ -0,0 +1,49 @@
+uffizzi-compose-list - list compose environments (previews) in a project
+================================================================
+
+## SYNOPSIS
+    uffizzi compose list [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Lists all compose environments (previews) for a project,
+    including active, building, deploying and failed compose
+    environments (previews).
+
+    For more information on Uffizzi compose environments (previews), see:
+    https://docs.uffizzi.com/references/cli/
+
+## FLAGS
+    --filter=METADATA
+        Metadata to filter list of deployments.
+
+    --output=pretty-json
+        Use this option for a more detailed description of listed
+        deployments.
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## EXAMPLES
+    To list all compose environments (previews) in the default project, run:
+
+        $ uffizzi compose list
+
+    To list all compose environments (previews) in a project with name my_project, run:
+
+        $ uffizzi compose list --project="my_project"
+
+    To list all compose environments (previews) in json format, run:
+
+        $ uffizzi compose list --output="pretty-json"
+
+    To list all compose environments (previews) filtered by metadata using single
+    label, run:
+
+        $ uffizzi compose list --filter github.repo=my_repo
+
+    To list all compose environments (previews) filtered by metadata using multiple
+    labels, run:
+
+        $ uffizzi compose list \
+        --filter="github.repo=my_repo github.pull_request.number=23"

data/man/uffizzi-compose-service-list

@@ -0,0 +1,42 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-COMPOSE\-SERVICE\-LIST" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-compose\-service\-list\fR
+.P
+uffizzi\-compose\-service\-list \- list the container services of a given compose environment (preview) ================================================================
+.SH "SYNOPSIS"
+.nf
+uffizzi compose service list [COMPOSE_ENVIRONMENT_ID] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Shows a list of the container services that make up a given
+compose environment (preview) deployment\.
+
+This command can fail for the following reasons:
+    \- There is no compose environment (preview)
+      with the given COMPOSE_ENVIRONMENT_ID
+
+For more information on preview services, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[COMPOSE_ENVIRONMENT_ID]
+    The ID of the compose environment (preview) you want to list services for\.
+.fi
+.SH "UFFIZZI WIDE FLAGS"
+.nf
+These flags are available to all commands: \-\-project\. Run $ uffizzi
+help for details\.
+.fi
+.SH "EXAMPLES"
+.nf
+The following command lists the container services
+for a compose environment (preview) with
+COMPOSE_ENVIRONMENT_ID deployment\-56:
+
+    $ uffizzi compose service list deployment\-56
+.fi
+