uffizzi-cli 0.11.5 → 1.0.0

data/lib/uffizzi/cli.rb

@@ -24,6 +24,14 @@ module Uffizzi
       Login.new(options).run
     end
 
+    desc 'login_by_identity_token [OPTIONS]', 'Login or register to Uffizzi to view and manage your previews'
+    method_option :server, required: true, aliases: '-s'
+    method_option :token, required: true, aliases: '-t'
+    def login_by_identity_token
+      require_relative 'cli/login_by_identity_token'
+      LoginByIdentityToken.new(options).run
+    end
+
     desc 'logout', 'Log out of a Uffizzi user account'
     def logout
       require_relative 'cli/logout'

data/lib/uffizzi/clients/api/api_client.rb

@@ -13,6 +13,13 @@ module ApiClient
     build_response(response)
   end
 
+  def create_ci_session(server, params = {})
+    uri = ci_session_uri(server)
+    response = http_client.make_post_request(uri, params)
+
+    build_response(response)
+  end
+
   def destroy_session(server)
     uri = session_uri(server)
     response = http_client.make_delete_request(uri)
@@ -27,16 +34,16 @@ module ApiClient
     build_response(response)
   end
 
-  def fetch_credentials(server)
-    uri = credentials_uri(server)
+  def fetch_credentials(server, account_id)
+    uri = credentials_uri(server, account_id)
 
     response = http_client.make_get_request(uri)
 
     build_response(response)
   end
 
-  def check_credential(server, type)
-    uri = check_credential_uri(server, type)
+  def check_credential(server, account_id, type)
+    uri = check_credential_uri(server, account_id, type)
     response = http_client.make_get_request(uri)
 
     build_response(response)
@@ -49,8 +56,8 @@ module ApiClient
     build_response(response)
   end
 
-  def create_project(server, params)
-    uri = projects_uri(server)
+  def create_project(server, account_id, params)
+    uri = create_projects_uri(server, account_id)
     response = http_client.make_post_request(uri, params)
 
     build_response(response)
@@ -63,15 +70,15 @@ module ApiClient
     build_response(response)
   end
 
-  def create_credential(server, params)
-    uri = credentials_uri(server)
+  def create_credential(server, account_id, params)
+    uri = credentials_uri(server, account_id)
     response = http_client.make_post_request(uri, params)
 
     build_response(response)
   end
 
-  def update_credential(server, params, type)
-    uri = credential_uri(server, type)
+  def update_credential(server, account_id, params, type)
+    uri = credential_uri(server, account_id, type)
     response = http_client.make_put_request(uri, params)
 
     build_response(response)
@@ -84,8 +91,8 @@ module ApiClient
     build_response(response)
   end
 
-  def delete_credential(server, credential_type)
-    uri = credential_uri(server, credential_type)
+  def delete_credential(server, account_id, credential_type)
+    uri = credential_uri(server, account_id, credential_type)
     response = http_client.make_delete_request(uri)
 
     build_response(response)
@@ -147,8 +154,8 @@ module ApiClient
     build_response(response)
   end
 
-  def fetch_deployments(server, project_slug)
-    uri = deployments_uri(server, project_slug)
+  def fetch_deployments(server, project_slug, filter)
+    uri = deployments_uri(server, project_slug, filter)
     response = http_client.make_get_request(uri)
 
     build_response(response)

data/lib/uffizzi/clients/api/api_routes.rb

@@ -15,6 +15,10 @@ module ApiRoutes
     "#{server}/api/cli/v1/projects"
   end
 
+  def create_projects_uri(server, account_id)
+    "#{server}/api/cli/v1/accounts/#{account_id}/projects"
+  end
+
   def secret_uri(server, project_slug, id)
     path_id = CGI.escape(id)
     "#{server}/api/cli/v1/projects/#{project_slug}/secrets/#{path_id}"
@@ -28,12 +32,18 @@ module ApiRoutes
     "#{server}/api/cli/v1/session"
   end
 
+  def ci_session_uri(server)
+    "#{server}/api/cli/v1/ci/session"
+  end
+
   def validate_compose_file_uri(server, project_slug)
     "#{compose_files_uri(server, project_slug)}/validate"
   end
 
-  def deployments_uri(server, project_slug)
-    "#{server}/api/cli/v1/projects/#{project_slug}/deployments"
+  def deployments_uri(server, project_slug, filter = nil)
+    return "#{server}/api/cli/v1/projects/#{project_slug}/deployments" if filter.nil?
+
+    "#{server}/api/cli/v1/projects/#{project_slug}/deployments?q=#{filter.to_json}"
   end
 
   def deployment_uri(server, project_slug, deployment_id)
@@ -52,20 +62,20 @@ module ApiRoutes
     "#{server}/api/cli/v1/projects/#{project_slug}/deployments/#{deployment_id}/events"
   end
 
-  def check_credential_uri(server, type)
-    "#{server}/api/cli/v1/account/credentials/#{type}/check_credential"
+  def check_credential_uri(server, account_id, type)
+    "#{server}/api/cli/v1/accounts/#{account_id}/credentials/#{type}/check_credential"
   end
 
-  def credentials_uri(server)
-    "#{server}/api/cli/v1/account/credentials"
+  def credentials_uri(server, account_id)
+    "#{server}/api/cli/v1/accounts/#{account_id}/credentials"
   end
 
   def preview_services_uri(server, project_slug, deployment_id)
     "#{server}/api/cli/v1/projects/#{project_slug}/deployments/#{deployment_id}/containers"
   end
 
-  def credential_uri(server, credential_type)
-    "#{server}/api/cli/v1/account/credentials/#{credential_type}"
+  def credential_uri(server, account_id, credential_type)
+    "#{server}/api/cli/v1/accounts/#{account_id}/credentials/#{credential_type}"
   end
 
   def preview_service_logs_uri(server, project_slug, deployment_id, container_name)

data/lib/uffizzi/clients/api/http_client.rb

@@ -50,13 +50,13 @@ module Uffizzi
       headers = { 'Content-Type' => 'application/json' }
       request = case method
                 when :get
-                  Net::HTTP::Get.new(uri.path, headers)
+                  Net::HTTP::Get.new(uri.request_uri, headers)
                 when :post
-                  Net::HTTP::Post.new(uri.path, headers)
+                  Net::HTTP::Post.new(uri.request_uri, headers)
                 when :delete
-                  Net::HTTP::Delete.new(uri.path, headers)
+                  Net::HTTP::Delete.new(uri.request_uri, headers)
                 when :put
-                  Net::HTTP::Put.new(uri.path, headers)
+                  Net::HTTP::Put.new(uri.request_uri, headers)
       end
       if request.instance_of?(Net::HTTP::Post) || request.instance_of?(Net::HTTP::Put)
         request.body = params.to_json

data/lib/uffizzi/helpers/connect_helper.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Uffizzi
+  module ConnectHelper
+    class << self
+      def get_docker_registry_data(options)
+        registry_url = options[:registry] || ENV['DOCKER_REGISTRY_URL'] || Uffizzi.ui.ask('Registry Domain:')
+        username = options[:username] || ENV['DOCKER_REGISTRY_USERNAME'] || Uffizzi.ui.ask('Username:')
+        password = options[:password] || ENV['DOCKER_REGISTRY_PASSWORD'] || Uffizzi.ui.ask('Password:', echo: false)
+
+        [registry_url, username, password]
+      end
+
+      def get_docker_hub_data(options)
+        username = options[:username] || ENV['DOCKERHUB_USERNAME'] || Uffizzi.ui.ask('Username:')
+        password = options[:password] || ENV['DOCKERHUB_PASSWORD'] || Uffizzi.ui.ask('Password:', echo: false)
+
+        [username, password]
+      end
+
+      def get_acr_data(options)
+        registry_url = options[:registry] || ENV['ACR_REGISTRY_URL'] || Uffizzi.ui.ask('Registry Domain:')
+        username = options[:username] || ENV['ACR_USERNAME'] || Uffizzi.ui.ask('Docker ID:')
+        password = options[:password] || ENV['ACR_PASSWORD'] || Uffizzi.ui.ask('Password/Access Token:', echo: false)
+
+        [registry_url, username, password]
+      end
+
+      def get_ecr_data(options)
+        registry_url = options[:registry] || ENV['AWS_REGISTRY_URL'] || Uffizzi.ui.ask('Registry Domain:')
+        access_key_id = options[:id] || ENV['AWS_ACCESS_KEY_ID'] || Uffizzi.ui.ask('Access key ID:')
+        secret_access_key = options[:secret] || ENV['AWS_SECRET_ACCESS_KEY'] || Uffizzi.ui.ask('Secret access key:', echo: false)
+
+        [registry_url, access_key_id, secret_access_key]
+      end
+
+      def get_ghcr_data(options)
+        username = options[:username] || ENV['GITHUB_USERNAME'] || Uffizzi.ui.ask('Github Username:')
+        password = options[:token] || ENV['GITHUB_ACCESS_TOKEN'] || Uffizzi.ui.ask('Access Token:', echo: false)
+
+        [username, password]
+      end
+    end
+  end
+end

data/lib/uffizzi/services/project_service.rb

@@ -24,6 +24,7 @@ class ProjectService
       Uffizzi.ui.say("Project name: #{project[:name]}")
       Uffizzi.ui.say("Project slug: #{project[:slug]}")
       Uffizzi.ui.say("Description: #{project[:description]}".strip)
+      Uffizzi.ui.say("Account name: #{project[:account][:name]}".strip)
       Uffizzi.ui.say("Created: #{project[:created_at]}")
       default_compose = project[:default_compose].nil? ? nil : project[:default_compose][:source]
       Uffizzi.ui.say("Default compose: #{default_compose}".strip)

data/lib/uffizzi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Uffizzi
-  VERSION = '0.11.5'
+  VERSION = '1.0.0'
 end

data/man/uffizzi-connect

@@ -1,43 +1,42 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "UFFIZZI\-CONNECT" "" "July 2022" ""
+.TH "UFFIZZI\-CONNECT" "" "August 2022" ""
 .SH "NAME"
 \fBuffizzi\-connect\fR \- grant a Uffizzi user account access to external services
 .SH "SYNOPSIS"
-.nf
-uffizzi connect COMMAND
-.fi
+\fBuffizzi connect\fR COMMAND [\-\-skip\-raise\-existence\-error] [\-\-update\-credential\-if\-exists]
 .SH "DESCRIPTION"
-.nf
-Grants a Uffizzi user account access to external services
-
+Grants a Uffizzi user account access to external services\.
+.P
 For more information on connecting to external services, see:
+.br
 https://github\.com/UffizziCloud/uffizzi_cli
-.fi
 .SH "COMMANDS"
-.nf
 COMMAND is one of the following:
-
-acr
-    Connect to Azure Container Registry (azurecr\.io)\.
-
-docker\-hub
-    Connect to Docker Hub (hub\.docker\.com)\.
-
-ecr
-    Connect to Amazon Elastic Container Registry (amazonaws\.com)\.
-
-gcr
-    Connect to Google Container Registry (gcr\.io)\.
-
-ghcr
-    Connect to GitHub Container Registry (ghcr\.io)\.
-.fi
+.TP
+\fBacr\fR
+Connect to Azure Container Registry (azurecr\.io)\.
+.TP
+\fBdocker\-hub\fR
+Connect to Docker Hub (hub\.docker\.com)\.
+.TP
+\fBdocker\-registry\fR
+Connect to any registry implementing the Docker Registry HTTP API protocol
+.TP
+\fBecr\fR
+Connect to Amazon Elastic Container Registry (amazonaws\.com)\.
+.TP
+\fBgcr\fR
+Connect to Google Container Registry (gcr\.io)\.
+.TP
+\fBghcr\fR
+Connect to GitHub Container Registry (ghcr\.io)\.
 .SH "FLAGS"
-.nf
-\-\-skip\-raise\-existence\-error        If credential exist, do not raise an exception, just print a message
-
-\-\-update\-credential\-if\-exists       Update credential if it exists
-.fi
+.TP
+\fB\-\-skip\-raise\-existence\-error\fR
+If credential exists, do not raise an exception, just print a message\.
+.TP
+\fB\-\-update\-credential\-if\-exists\fR
+Update credential if it exists\.
 .P
-Run \'uffizzi connect COMMAND \-\-help\' for more information on a command\.
+Run \fBuffizzi connect COMMAND \-\-help\fR for more information on a command\.

data/man/uffizzi-connect-acr

@@ -1,35 +1,37 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "UFFIZZI\-CONNECT\-ACR" "" "May 2022" ""
+.TH "UFFIZZI\-CONNECT\-ACR" "" "August 2022" ""
 .SH "NAME"
 \fBuffizzi\-connect\-acr\fR \- grant a Uffizzi user account access to a private Azure Container Registry (ACR)
 .SH "SYNOPSIS"
-.nf
-uffizzi connect acr
-.fi
+\fBuffizzi connect acr\fR [\-\-registry=REGISTRY] [\-\-username=USERNAME] [\-\-password=PASSWORD]
 .SH "DESCRIPTION"
-.nf
-Given valid credentials, grants a Uffizzi user account access
-to a private Azure Container Registry
-
-This command can fail for the following reasons:
-    \- The active user does not have permission to connect
-      external services\.
-    \- The given credentials are invalid\.
-
+Given valid credentials, grants a Uffizzi user account access to a private Azure Container Registry
+.P
+Credentials can be provided interactively or non\-interactively via command options or environment variables:
+.br
+\fBACR_REGISTRY_URL\fR, \fBACR_REGISTRY_USERNAME\fR, \fBACR_REGISTRY_PASSWORD\fR
+.P
+This command can fail for the following reasons: \- The active user does not have permission to connect external services\. \- The given credentials are invalid\.
+.P
 For more information on connecting to external services, see:
+.br
 https://github\.com/UffizziCloud/uffizzi_cli
-
-For detailed instructions on configuring webhooks to send push
-notifications to Uffizzi, see
+.P
+For detailed instructions on configuring webhooks to send push notifications to Uffizzi, see:
+.br
 https://docs\.uffizzi\.com/guides/container\-registry\-integrations
-.fi
+.SH "OPTIONS"
+.TP
+\fB\-r\fR, \fB\-\-registry=<registry>\fR
+URL of the service\.
+.TP
+\fB\-u\fR, \fB\-\-username=<username>\fR
+Username for the service\.
+.TP
+\fB\-p\fR, \fB\-\-password=<password>\fR
+Password for the service\.
 .SH "EXAMPLES"
-.nf
-The following command will prompt the user to enter ACR
-credentials, including registry domain, Docker ID and
-password or access token:
-
-    $ uffizzi connect acr
-.fi
-
+The following command will prompt the user to enter ACR credentials, including registry domain, Docker ID and password or access token:
+.P
+\fBuffizzi connect acr\fR

data/man/uffizzi-connect-acr.ronn

@@ -1,28 +1,42 @@
-uffizzi-connect-acr - grant a Uffizzi user account access to a private Azure Container Registry (ACR)
-================================================================
+# uffizzi-connect-acr - grant a Uffizzi user account access to a private Azure Container Registry (ACR)
 
 ## SYNOPSIS
-    uffizzi connect acr
+
+`uffizzi connect acr` [--registry=REGISTRY] [--username=USERNAME] [--password=PASSWORD]
 
 ## DESCRIPTION
-    Given valid credentials, grants a Uffizzi user account access 
-    to a private Azure Container Registry
 
-    This command can fail for the following reasons:
-        - The active user does not have permission to connect 
-          external services.
-        - The given credentials are invalid.
+Given valid credentials, grants a Uffizzi user account access 
+to a private Azure Container Registry
+
+Credentials can be provided interactively or non-interactively
+via command options or environment variables:  
+`ACR_REGISTRY_URL`, `ACR_REGISTRY_USERNAME`, `ACR_REGISTRY_PASSWORD`
+
+This command can fail for the following reasons:
+- The active user does not have permission to connect external services.
+- The given credentials are invalid.
+
+For more information on connecting to external services, see:  
+https://github.com/UffizziCloud/uffizzi_cli
 
-    For more information on connecting to external services, see:
-    https://github.com/UffizziCloud/uffizzi_cli
+For detailed instructions on configuring webhooks to send push
+notifications to Uffizzi, see:  
+https://docs.uffizzi.com/guides/container-registry-integrations
 
-    For detailed instructions on configuring webhooks to send push
-    notifications to Uffizzi, see 
-    https://docs.uffizzi.com/guides/container-registry-integrations
+## OPTIONS
+
+* `-r`, `--registry=<registry>`:
+  URL of the service.
+* `-u`, `--username=<username>`:
+  Username for the service.
+* `-p`, `--password=<password>`:
+  Password for the service.
 
 ## EXAMPLES
-    The following command will prompt the user to enter ACR 
-    credentials, including registry domain, Docker ID and 
-    password or access token:
-          
-        $ uffizzi connect acr
+
+The following command will prompt the user to enter ACR 
+credentials, including registry domain, Docker ID and 
+password or access token:
+
+`uffizzi connect acr`

data/man/uffizzi-connect-docker-hub

@@ -1,34 +1,34 @@
 .\" generated with Ronn-NG/v0.9.1
 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "UFFIZZI\-CONNECT\-DOCKER\-HUB" "" "May 2022" ""
+.TH "UFFIZZI\-CONNECT\-DOCKER\-HUB" "" "August 2022" ""
 .SH "NAME"
 \fBuffizzi\-connect\-docker\-hub\fR \- grant a Uffizzi user account access to a private Docker Hub registry\.
 .SH "SYNOPSIS"
-.nf
-uffizzi connect docker\-hub
-.fi
+\fBuffizzi connect docker\-hub\fR [\-\-username=USERNAME] [\-\-password=PASSWORD]
 .SH "DESCRIPTION"
-.nf
-Given valid credentials, grants a Uffizzi user account access
-to a private Docker Hub registry
-
-This command can fail for the following reasons:
-    \- The active user does not have permission to connect
-      external services\.
-    \- The given credentials are invalid\.
-
+Given valid credentials, grants a Uffizzi user account access to a private Docker Hub registry
+.P
+Credentials can be provided interactively or non\-interactively via command options or environment variables:
+.br
+\fBDOCKERHUB_USERNAME\fR, \fBDOCKERHUB_PASSWORD\fR
+.P
+This command can fail for the following reasons: \- The active user does not have permission to connect external services\. \- The given credentials are invalid\.
+.P
 For more information on connecting to external services, see:
+.br
 https://github\.com/UffizziCloud/uffizzi_cli
-
-For detailed instructions on configuring webhooks to send push
-notifications to Uffizzi, see
+.P
+For detailed instructions on configuring webhooks to send push notifications to Uffizzi, see:
+.br
 https://docs\.uffizzi\.com/guides/container\-registry\-integrations
-.fi
+.SH "OPTIONS"
+.TP
+\fB\-u\fR, \fB\-\-username=<username>\fR
+Username for the service\.
+.TP
+\fB\-p\fR, \fB\-\-password=<password>\fR
+Password for the service\.
 .SH "EXAMPLES"
-.nf
-The following command will prompt the user to enter Docker Hub
-credentials, including Docker ID and password or access token:
-
-    $ uffizzi connect docker\-hub
-.fi
-
+The following command will prompt the user to enter Docker Hub credentials, including Docker ID and password or access token:
+.P
+\fBuffizzi connect docker\-hub\fR

data/man/uffizzi-connect-docker-hub.ronn

@@ -1,27 +1,39 @@
-uffizzi-connect-docker-hub - grant a Uffizzi user account access to a private Docker Hub registry.
-================================================================
+# uffizzi-connect-docker-hub - grant a Uffizzi user account access to a private Docker Hub registry.
 
 ## SYNOPSIS
-    uffizzi connect docker-hub
+
+`uffizzi connect docker-hub` [--username=USERNAME] [--password=PASSWORD]
 
 ## DESCRIPTION
-    Given valid credentials, grants a Uffizzi user account access 
-    to a private Docker Hub registry
 
-    This command can fail for the following reasons:
-        - The active user does not have permission to connect 
-          external services.
-        - The given credentials are invalid.
+Given valid credentials, grants a Uffizzi user account access 
+to a private Docker Hub registry
+
+Credentials can be provided interactively or non-interactively
+via command options or environment variables:  
+`DOCKERHUB_USERNAME`, `DOCKERHUB_PASSWORD`
+
+This command can fail for the following reasons:
+- The active user does not have permission to connect external services.
+- The given credentials are invalid.
+
+For more information on connecting to external services, see:  
+https://github.com/UffizziCloud/uffizzi_cli
 
-    For more information on connecting to external services, see:
-    https://github.com/UffizziCloud/uffizzi_cli
+For detailed instructions on configuring webhooks to send push
+notifications to Uffizzi, see:  
+https://docs.uffizzi.com/guides/container-registry-integrations
 
-    For detailed instructions on configuring webhooks to send push
-    notifications to Uffizzi, see 
-    https://docs.uffizzi.com/guides/container-registry-integrations
+## OPTIONS
+
+* `-u`, `--username=<username>`:
+  Username for the service.
+* `-p`, `--password=<password>`:
+  Password for the service.
 
 ## EXAMPLES
-    The following command will prompt the user to enter Docker Hub
-    credentials, including Docker ID and password or access token:
-          
-        $ uffizzi connect docker-hub
+
+The following command will prompt the user to enter Docker Hub
+credentials, including Docker ID and password or access token:
+
+`uffizzi connect docker-hub`

data/man/uffizzi-connect-docker-registry

@@ -0,0 +1,37 @@
+.\" generated with Ronn-NG/v0.9.1
+.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
+.TH "UFFIZZI\-CONNECT\-DOCKER\-REGISTRY" "" "August 2022" ""
+.SH "NAME"
+\fBuffizzi\-connect\-docker\-registry\fR \- grant a Uffizzi user account access to a Docker Container Registry\.
+.SH "SYNOPSIS"
+\fBuffizzi connect docker\-registry\fR [\-\-registry=REGISTRY] [\-\-username=USERNAME] [\-\-password=PASSWORD]
+.SH "DESCRIPTION"
+Given valid credentials, grants a Uffizzi user account access to a Docker Container Registry
+.P
+Credentials can be provided interactively or non\-interactively via command options or environment variables:
+.br
+\fBDOCKER_REGISTRY_URL\fR, \fBDOCKER_REGISTRY_USERNAME\fR, \fBDOCKER_REGISTRY_PASSWORD\fR
+.P
+This command can fail for the following reasons: \- The active user does not have permission to connect external services\. \- The given credentials are invalid\.
+.P
+For more information on connecting to external services, see:
+.br
+https://github\.com/UffizziCloud/uffizzi_cli
+.P
+For detailed instructions on configuring webhooks to send push notifications to Uffizzi, see:
+.br
+https://docs\.uffizzi\.com/guides/container\-registry\-integrations
+.SH "OPTIONS"
+.TP
+\fB\-r\fR, \fB\-\-registry=<registry>\fR
+URL of the service\.
+.TP
+\fB\-u\fR, \fB\-\-username=<username>\fR
+Username for the service\.
+.TP
+\fB\-p\fR, \fB\-\-password=<password>\fR
+Password for the service\.
+.SH "EXAMPLES"
+The following command will prompt the user to enter Docker Container Registry credentials, including username and password:
+.P
+\fBuffizzi connect docker\-registry\fR

data/man/uffizzi-connect-docker-registry.ronn

@@ -0,0 +1,41 @@
+# uffizzi-connect-docker-registry - grant a Uffizzi user account access to a Docker Container Registry.
+
+## SYNOPSIS
+
+`uffizzi connect docker-registry` [--registry=REGISTRY] [--username=USERNAME] [--password=PASSWORD]
+
+## DESCRIPTION
+
+Given valid credentials, grants a Uffizzi user account access
+to a Docker Container Registry
+
+Credentials can be provided interactively or non-interactively
+via command options or environment variables:  
+`DOCKER_REGISTRY_URL`, `DOCKER_REGISTRY_USERNAME`, `DOCKER_REGISTRY_PASSWORD`
+
+This command can fail for the following reasons:
+- The active user does not have permission to connect external services.
+- The given credentials are invalid.
+
+For more information on connecting to external services, see:  
+https://github.com/UffizziCloud/uffizzi_cli
+
+For detailed instructions on configuring webhooks to send push
+notifications to Uffizzi, see:  
+https://docs.uffizzi.com/guides/container-registry-integrations
+
+## OPTIONS
+
+* `-r`, `--registry=<registry>`:
+  URL of the service.
+* `-u`, `--username=<username>`:
+  Username for the service.
+* `-p`, `--password=<password>`:
+  Password for the service.
+
+## EXAMPLES
+
+The following command will prompt the user to enter Docker Container Registry
+credentials, including username and password:
+
+`uffizzi connect docker-registry`