uffizzi-cli 2.0.34 → 2.0.36

data/man/uffizzi-preview-update

@@ -0,0 +1,61 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UPDATE" "" "August 2023" ""
+.SH "NAME"
+\fBupdate\fR \- update a compose environment (preview)
+.SH "SYNOPSIS"
+.nf
+uffizzi compose update [COMPOSE_ENVIRONMENT_ID] [COMPOSE_FILE] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Given a compose environment (preview) ID and new compose file,
+update a compose environment (preview)\. Updating a compose
+environment (preview) does not change its compose environment (preview) URL\.
+
+This command can fail for the following reasons:
+    \- There is no compose environment (preview) with the given COMPOSE_ENVIRONMENT_ID
+    \- The COMPOSE_FILE specified is invalid
+
+For more information on Uffizzi previews, 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 update\.
+
+[COMPOSE_FILE]
+    The new compose file you want to compose environment (preview)\.
+.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
+The following command updates a compose environment (preview)
+with ID deployment\-67 using compose file docker\-compose\.alt\.yml:
+
+    $ uffizzi compose update deployment\-67 docker\-compose\.alt\.yml
+
+To update a compose with single label, run:
+
+    $ uffizzi compose update \e
+    deployment\-67 docker\-compose\.alt\.yml \e
+    \-\-set\-labels github\.repo=my_repo
+
+To update a compose with multiple labels, run:
+
+    $ uffizzi compose update \e
+    deployment\-67 docker\-compose\.alt\.yml \e
+    \-\-set\-labels="github\.repo=my_repo github\.pull_request\.number=23"
+.fi
+

data/man/uffizzi-preview-update.ronn

@@ -0,0 +1,51 @@
+uffizzi compose update - update a compose environment (preview)
+================================================================
+
+## SYNOPSIS
+    uffizzi compose update [COMPOSE_ENVIRONMENT_ID] [COMPOSE_FILE] [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Given a compose environment (preview) ID and new compose file,
+    update a compose environment (preview). Updating a compose
+    environment (preview) does not change its compose environment (preview) URL.
+
+    This command can fail for the following reasons:
+        - There is no compose environment (preview) with the given COMPOSE_ENVIRONMENT_ID
+        - The COMPOSE_FILE specified is invalid
+
+    For more information on Uffizzi previews, see:
+    https://docs.uffizzi.com/references/cli/
+
+## POSITIONAL ARGUMENTS
+    [COMPOSE_ENVIRONMENT_ID]
+        The ID of the compose environment (preview) that you want to update.
+
+    [COMPOSE_FILE]
+        The new compose file you want to compose environment (preview).
+
+## 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
+    The following command updates a compose environment (preview)
+    with ID deployment-67 using compose file docker-compose.alt.yml:
+
+        $ uffizzi compose update deployment-67 docker-compose.alt.yml
+
+    To update a compose with single label, run:
+
+        $ uffizzi compose update \
+        deployment-67 docker-compose.alt.yml \
+        --set-labels github.repo=my_repo
+
+    To update a compose with multiple labels, run:
+
+        $ uffizzi compose update \
+        deployment-67 docker-compose.alt.yml \
+        --set-labels="github.repo=my_repo github.pull_request.number=23"

data/man/uffizzi-preview.ronn

@@ -0,0 +1,33 @@
+uffizzi-compose - manage previews
+================================================================
+
+## SYNOPSIS
+    uffizzi compose COMMAND [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    Manage Uffizzi previews
+
+    For more information on Uffizzi previews, see:
+    https://docs.uffizzi.com/references/cli/
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi
+    help for details.
+
+## COMMANDS
+    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)
+
+##
+Run 'uffizzi compose COMMAND --help' for more information on a command.

data/man/uffizzi-preview_service_logs

@@ -0,0 +1,59 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PREVIEW_SERVICE_LOGS" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-preview_service_logs\fR
+.P
+uffizzi\-compose\-service\-logs \- show the logs for a container service of a compose environment (preview) ================================================================
+.SH "SYNOPSIS"
+.nf
+uffizzi compose service logs LOG_TYPE [COMPOSE_ENVIRONMENT_ID] [SERVICE] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Shows the logs for a given container service of a given compose environment (preview)\.
+
+This command can fail for the following reasons:
+    \- There is no compose environment (preview) with the given COMPOSE_ENVIRONMENT_ID
+    \- There is no service with the name SERVICE
+
+For more information on service logs, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "LOG_TYPE"
+.nf
+LOG_TYPE is one of the following:
+
+build
+    The build logs of a service\.
+
+container
+    The container logs of a service\.
+.fi
+.SH "POSITIONAL ARGUMENTS"
+.nf
+[COMPOSE_ENVIRONMENT_ID]
+    The ID of the compose environment (preview) that includes the service you want to
+    show logs for\.
+
+[SERVICE]
+    The name of the service you want to show logs 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 build logs for the service web\-app of the
+compose environment (preview) with ID deployment\-14:
+
+    $ uffizzi compose service logs build deployment\-14 web\-app
+
+The following command shows container logs for the service postgres\-db of
+the compose environment (preview) with ID deployment\-14:
+
+    $ uffizzi compose service logs container deployment\-14 postgres\-db
+.fi
+

data/man/uffizzi-preview_service_logs.ronn

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

data/man/uffizzi-project

@@ -0,0 +1,47 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\fR \- manage Uffizzi projects
+.SH "SYNOPSIS"
+.nf
+uffizzi project COMMAND [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Manage Uffizzi projects
+
+For more information on Uffizzi projects, see:
+https://docs\.uffizzi\.com/references/cli/
+.fi
+.SH "COMMANDS"
+.nf
+COMMAND is one of the following:
+
+ compose
+    Manage the compose file for a project\.
+
+ create
+    Create a new project\.
+
+ delete
+    Delete a project\.
+
+ describe
+    Display project meta data\.
+
+ list
+    List all projects in the account\.
+
+ secret
+    Manage secrets for a project\.
+
+ set\-default
+    Set the default project in the uffizzi configuration\. Also see
+    $ uffizzi config help for details\.
+
+ update OPTIONS
+    Update a project\'s metadata\.
+.fi
+.P
+Run $ uffizzi project COMMAND \-\-help for more information on a command\.

data/man/uffizzi-project-compose

@@ -0,0 +1,40 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT\-COMPOSE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\-compose\fR \- manage the compose file for a project
+.SH "SYNOPSIS"
+.nf
+uffizzi project compose COMMAND [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+By default, manages the compose file for the default project\. Use the
+\-\-project flag to manage the compose file of a different project\.
+
+For more information on the uffizzi project compose command, see:
+https://docs\.uffizzi\.com/references/cli/
+
+For more information on the Uffizzi Compose specification, see:
+https://docs\.uffizzi\.com/references/compose\-spec
+.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:
+
+ set
+    Set the configuration of a project with a compose file\.
+
+ describe
+    Display details of a compose file\.
+
+ unset
+    Unset the compose file for a project\.
+.fi
+.P
+Run ‘uffizzi project compose COMMAND \-\-help’ for more information on a command\.

data/man/uffizzi-project-compose-describe

@@ -0,0 +1,37 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT\-COMPOSE\-DESCRIBE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\-compose\-describe\fR \- show metadata for a compose file
+.SH "SYNOPSIS"
+.nf
+uffizzi project compose describe [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+By default, shows the contents of the default project’s compose
+file\. Use the \-\-project flag to describe the compose file of a
+different project\.
+
+This command can fail for the following reasons:
+    \- A compose file is not set for the project\.
+
+For more information on the uffizzi project compose command, see:
+https://docs\.uffizzi\.com/references/cli/
+
+For more information on the Uffizzi Compose specification, see:
+https://docs\.uffizzi\.com/references/compose\-spec
+.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 the contents of the default project’s
+compose file:
+
+    $ uffizzi project compose describe
+.fi
+

data/man/uffizzi-project-compose-describe.ronn

@@ -0,0 +1,29 @@
+  uffizzi-project-compose-describe - show metadata for a compose file
+================================================================
+
+## SYNOPSIS
+    uffizzi project compose describe [UFFIZZI_WIDE_FLAG ...] 
+
+## DESCRIPTION
+    By default, shows the contents of the default project’s compose 
+    file. Use the --project flag to describe the compose file of a
+    different project.
+
+    This command can fail for the following reasons:
+        - A compose file is not set for the project.
+    
+    For more information on the uffizzi project compose command, see:
+    https://docs.uffizzi.com/references/cli/
+
+    For more information on the Uffizzi Compose specification, see:
+    https://docs.uffizzi.com/references/compose-spec
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi 
+    help for details.
+
+## EXAMPLES
+    The following command prints the contents of the default project’s 
+    compose file: 
+
+        $ uffizzi project compose describe

data/man/uffizzi-project-compose-set

@@ -0,0 +1,66 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT\-COMPOSE\-SET" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\-compose\-set\fR \- sets the configuration of a project with a compose file
+.SH "SYNOPSIS"
+.nf
+uffizzi project compose set [\-\-repository=REPOSITORY]
+     [\-\-branch=BRANCH] [\-\-path=PATH_TO_COMPOSE_FILE]
+     [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+By default, sets the configuration of the default project with the
+specified compose file\. Use the \-\-project flag to set the compose
+file of a different project\. If already set, this command overrides
+the project\'s configuration with the new compose file\. The compose
+file must exist within a GitHub repository\.
+
+This command can fail for the following reasons:
+    \- The repository, branch, or path to the compose file as
+      specified does not exist\.
+    \- uffizzi is not authorized to access the repository\.
+      Run $ uffizzi connect \-\-help for details about connecting to
+      external services\.
+    \- The compose file is invalid\.
+
+For more information on the uffizzi project compose command, see:
+https://docs\.uffizzi\.com/references/cli/
+
+For more information on the Uffizzi Compose specification, see:
+https://docs\.uffizzi\.com/references/compose\-spec
+.fi
+.SH "FLAGS"
+.nf
+\-\-repository=REPOSITORY
+    The repository that contains the compose file you want to set
+    for a project\.
+
+\-\-branch=BRANCH
+    The branch of the repository that contains the compose file you
+    want to set for a project\. If not specified, the default branch
+    as configured on GitHub is used\.
+
+\-\-path=PATH_TO_COMPOSE_FILE
+    The path to the compose file that you want to set for a project\.
+    This compose file is used as the default when creating previews\.
+    Run $ uffizzi preview \-\-help for details\.
+.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 sets a compose file for the default project\.
+The compose file (docker\-compose\.uffizzi\.yml) exists in the main
+branch of a GitHub repository called example\-app:
+
+    $ uffizzi project compose set \e
+      \-\-repository="github\.com/example/example\-app" \e
+      \-\-branch="main" \e
+      \-\-path="app/docker\-compose\.uffizzi\.yml"
+.fi
+

data/man/uffizzi-project-compose-set.ronn

@@ -0,0 +1,57 @@
+  uffizzi-project-compose-set - sets the configuration of a project with a compose file
+================================================================
+
+## SYNOPSIS
+    uffizzi project compose set [--repository=REPOSITORY] 
+         [--branch=BRANCH] [--path=PATH_TO_COMPOSE_FILE] 
+         [UFFIZZI_WIDE_FLAG ...] 
+
+## DESCRIPTION
+    By default, sets the configuration of the default project with the
+    specified compose file. Use the --project flag to set the compose 
+    file of a different project. If already set, this command overrides 
+    the project's configuration with the new compose file. The compose 
+    file must exist within a GitHub repository. 
+
+    This command can fail for the following reasons:  
+        - The repository, branch, or path to the compose file as 
+          specified does not exist.
+        - uffizzi is not authorized to access the repository. 
+          Run $ uffizzi connect --help for details about connecting to
+          external services.
+        - The compose file is invalid.
+
+    For more information on the uffizzi project compose command, see:
+    https://docs.uffizzi.com/references/cli/
+
+    For more information on the Uffizzi Compose specification, see:
+    https://docs.uffizzi.com/references/compose-spec
+
+## FLAGS
+    --repository=REPOSITORY
+        The repository that contains the compose file you want to set 
+        for a project. 
+
+    --branch=BRANCH
+        The branch of the repository that contains the compose file you
+        want to set for a project. If not specified, the default branch 
+        as configured on GitHub is used.
+
+    --path=PATH_TO_COMPOSE_FILE
+        The path to the compose file that you want to set for a project.
+        This compose file is used as the default when creating previews.
+        Run $ uffizzi preview --help for details. 
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi 
+    help for details.
+
+## EXAMPLES
+    The following command sets a compose file for the default project.
+    The compose file (docker-compose.uffizzi.yml) exists in the main 
+    branch of a GitHub repository called example-app:
+
+        $ uffizzi project compose set \
+          --repository="github.com/example/example-app" \
+          --branch="main" \
+          --path="app/docker-compose.uffizzi.yml"

data/man/uffizzi-project-compose-unset

@@ -0,0 +1,35 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT\-COMPOSE\-UNSET" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\-compose\-unset\fR \- unset the compose file for a project
+.SH "SYNOPSIS"
+.nf
+uffizzi project compose unset [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+By default, unsets the compose file for the default project\. Use the
+\-\-project flag to unset the compose file of a different project\.
+
+This command can fail for the following reasons:
+    \- A compose file is not set for the project\.
+
+For more information on the uffizzi project compose command, see:
+https://docs\.uffizzi\.com/references/cli/
+
+For more information on the Uffizzi Compose specification, see:
+https://docs\.uffizzi\.com/references/compose\-spec
+.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 unsets the default project’s compose file:
+
+    $ uffizzi project compose unset
+.fi
+

data/man/uffizzi-project-compose-unset.ronn

@@ -0,0 +1,27 @@
+  uffizzi-project-compose-unset - unset the compose file for a project
+================================================================
+
+## SYNOPSIS
+    uffizzi project compose unset [UFFIZZI_WIDE_FLAG ...] 
+
+## DESCRIPTION
+    By default, unsets the compose file for the default project. Use the 
+    --project flag to unset the compose file of a different project.
+
+    This command can fail for the following reasons:
+        - A compose file is not set for the project.
+    
+    For more information on the uffizzi project compose command, see:
+    https://docs.uffizzi.com/references/cli/
+
+    For more information on the Uffizzi Compose specification, see:
+    https://docs.uffizzi.com/references/compose-spec
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi 
+    help for details.
+
+## EXAMPLES
+    The following command unsets the default project’s compose file:
+
+        $ uffizzi project compose unset

data/man/uffizzi-project-compose.ronn

@@ -0,0 +1,34 @@
+  uffizzi-project-compose - manage the compose file for a project
+================================================================
+
+## SYNOPSIS
+    uffizzi project compose COMMAND [UFFIZZI_WIDE_FLAG ...]
+
+## DESCRIPTION
+    By default, manages the compose file for the default project. Use the 
+    --project flag to manage the compose file of a different project.
+
+    For more information on the uffizzi project compose command, see:
+    https://docs.uffizzi.com/references/cli/
+
+    For more information on the Uffizzi Compose specification, see:
+    https://docs.uffizzi.com/references/compose-spec
+
+## UFFIZZI WIDE FLAGS
+    These flags are available to all commands: --project. Run $ uffizzi 
+    help for details.
+
+## COMMANDS
+    COMMAND is one of the following:
+
+     set
+        Set the configuration of a project with a compose file.
+
+     describe
+        Display details of a compose file. 
+
+     unset
+        Unset the compose file for a project.
+
+Run ‘uffizzi project compose COMMAND --help’ for more information on a 
+command.

data/man/uffizzi-project-create

@@ -0,0 +1,50 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-PROJECT\-CREATE" "" "August 2023" ""
+.SH "NAME"
+\fBuffizzi\-project\-create\fR \- create a new project
+.SH "SYNOPSIS"
+.nf
+uffizzi project create [\-\-name=NAME] [\-\-slug=SLUG]
+     [\-\-description=DESCRIPTION] [UFFIZZI_WIDE_FLAG \|\.\|\.\|\.]
+.fi
+.SH "DESCRIPTION"
+.nf
+Create new project\.
+
+This command can fail for the following reasons:
+    \- The project \-\-description is too long\.
+    \- The project \-\-name flag is not specified\.
+    \- The project \-\-slug is malformed or used by another project\.
+
+For more information on the uffizzi project command, see:
+https:/docs\.uffizzi\.com/references/cli/
+.fi
+.SH "FLAGS"
+.nf
+\-\-description=DESCRIPTION
+   Description for the project you want to create\. Max of 256
+   characters\.
+
+\-\-name=NAME
+   Name for the project you want to create\.
+
+\-\-slug=SLUG
+   A URL\-compatible name\. Do not include whitespaces or special characters\.
+   Project slugs must be globally unique across all Uffizzi projects\.
+   If a slug is not provided, Uffizzi will automatically generate one\.
+.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 new project with name My App, project slug my\-app, and
+description "My first project", run:
+
+    $ uffizzi project create \-\-name="My App" \-\-slug="my\-app" \e
+      \-\-description="My first project"
+.fi
+