uffizzi-cli 0.5.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40afcffb213061f1da3d74393c334423329aabc97a7c28587659e7e1acdd704e
-  data.tar.gz: d2507263bca660a24dfdb6e1ba8927633be123810c58c17df0dfe6618744482f
+  metadata.gz: e9ab52c8638dc3d5a8f6245ba337da95fcf986e39040458add0c1128857014f8
+  data.tar.gz: b897ce235bc887bd161a7262fecddc28228b523b167338b599051ba370b704d3
 SHA512:
-  metadata.gz: c2399f33b5b86bd33f5051ddbaaaccb8116eb00840b64f4b29fdca4be758442d7e6af77306500ba1be34e77f5c7a556cb8ac8be689a4728879b47d558f86d413
-  data.tar.gz: 8b4078751fc9bdcc38f772af6ef8778de4bff5f61a57020eee5f3c2ff1f8b1c7b26c9b0d1b82d8c0ca8049f10a2cbc3c3280675f3ac7cb4aff162f5921a63c58
+  metadata.gz: a2976d6389a9a1d5c9d53ab66e34de98c391b250e2b4e5ebf636189b12f7e7a366e5140ef1c8583ce952d68fd8734600945402b6e38b10dea28700b71eb2bcf6
+  data.tar.gz: 78aa15c2dd0f21febc64c73c2a77e86de98ccda9a90278069ced243f3264f74240d5530aa67828515a4e03f858fb3e2d1d5d1713eca63127d027cbd4b3ea89ac

data/README.md

@@ -4,22 +4,20 @@ A command-line interace (CLI) for [Uffizzi App](https://github.com/UffizziCloud/
 
 ## Uffizzi Overview
 
-Uffizzi is the Full-stack Previews Engine that makes it easy for your team to preview code changes before merging—whether frontend, backend or microserivce. Define your full-stack apps with a familiar syntax based on Docker Compose, and Uffizzi will create on-demand test environments when you open pull requests or build new images. Preview URLs are updated when there’s a new commit, so your team can catch issues early, iterate quickly, and accelerate your release cycles.
+Uffizzi is an open-source engine for creating lightweight, ephemeral test environments for APIs and full-stack applications. Uffizzi enables teams to preview new features before merging and to mitigate the risk of introducing regressions into a codebase. Each preview gets a shareable URL that's updated when you push new commits or image tags, so teams can provide continual feedback during the development/QA process. Previews can be configured to expire or be destroyed when a pull request is closed, so environments exist only as long as they are needed. Uffizzi also helps deconflict shared development environments since previews are deployed as isolated namespaces—there is no risk of clobbering another developer's preview.
 
-## Getting started with Uffizzi
+While Uffizzi depends on Kubernetes, it does not require end-users to interface with Kubernetes directly. Instead, Uffizzi leverages Docker Compose as its configuration file format, so developers do not need modify Kubernetes manifests or even know about Kubernetes.
 
-The fastest and easiest way to get started with Uffizzi is via the fully hosted version available at https://uffizzi.com, which includes free plans for small teams and qualifying open-source projects.
-
-Alternatively, you can self-host Uffizzi via the open-source repositories available here on GitHub. The remainder of this README is intended for users interested in self-hosting Uffizzi or for those who are just curious about how Uffizzi works.
+Uffizzi is designed to integrate with any CI/CD system.
 
 ## Uffizzi Architecture
+<img src="https://github.com/UffizziCloud/uffizzi_app/blob/main/docs/images/uffizzi-architecture.png" description="Uffizzi Architecture" width="320"/>
 
 Uffizzi consists of the following components:
 
 - [Uffizzi App](https://github.com/UffizziCloud/uffizzi_app) - The primary REST API for creating and managing Previews
 - [Uffizzi Controller](https://github.com/UffizziCloud/uffizzi_controller) - A smart proxy service that handles requests from Uffizzi App to the Kubernetes API
 - Uffizzi CLI (this repository) - A command-line interface for Uffizzi App
-- [Uffizzi Dashboard](https://app.uffizzi.com) - A graphical user interface for Uffizzi App, available as a paid service at https://uffizzi.com
 
 To host Uffizzi yourself, you will also need the following external dependencies:
 
@@ -29,198 +27,153 @@ To host Uffizzi yourself, you will also need the following external dependencies
 
 ## Installation
 
-Add this line to your application's `Gemfile`:
-
-```ruby
-gem 'uffizzi-cli'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
-
-    $ gem install uffizzi-cli
-
-### Docker image
+The Uffizzi CLI can be used interactively or as part of an automated workflow (e.g. GitHub Actions). Both options use the `uffizzi/cli` container image available on Docker Hub.
 
-We also provide an image on Docker Hub:
+### Interactive mode
 
-```bash
-docker run -it --rm uffizzi/cli project list
+Run the CLI as a Docker container in interactive mode:
+```
+docker run --interactive --rm --tty --entrypoint=sh uffizzi/cli
 ```
 
 If you specify the following environment variables, the Docker image's
 entrypoint script can log you into Uffizzi before executing your command.
 
 - `UFFIZZI_USER`
-- `UFFIZZI_HOSTNAME`
+- `UFFIZZI_SERVER`
 - `UFFIZZI_PASSWORD`
 - `UFFIZZI_PROJECT` (optional)
 
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-Run rubocop:
-`bundle exec rubocop -A`
-
-## Testing
-
-Run tests:
-`bundle exec rake test`
+### Automated mode
 
-Run tests from a file:
-`bundle exec rake test TEST=test/uffizzi/cli/preview_test.rb`
-
-Run single test
-`bundle exec rake test TEST=test/uffizzi/cli/preview_test.rb TESTOPTS="--name=test_name"`
-
-## Commands
-
-### login
+If you want to use Uffizzi as part of an automated workflow, you can pass the Uffizzi commands to the Docker run command. For example:
 
 ```
-$ uffizzi login --user your@email.com --hostname localhost:8080
+docker run -it --rm uffizzi/cli project list
 ```
 
-Logging you into the app which you set in the hostname option.
-
-### login options
+## Sample commands and examples
 
-| Option       | Aliase | Description               |
-| ------------ | ------ | ------------------------- |
-| `--user`     | `-u`   | Your email for logging in |
-| `--hostname` |        | Adress of your app        |
+### help
 
-If hostname uses basic authentication you can specify options for it by setting `basic_auth_user` and `basic_auth_password` via `config set` command.
+The `help` subcommand can be used to see more information about a particular command.
 
-### project
+Examples:
 
 ```
-$ uffizzi project
+uffizzi help
 ```
 
-Use this command to configure your projects. This command has 2 subcommands `list` and `compose`.
-
 ```
-$ uffizzi project list
+uffizzi preview help
 ```
 
-Shows all your projects' slugs
-
-If you have only one project it will be added to your config file automatically, if there's more than one project you need to set up your project manually with the command `uffizzi config set YOUR_PROJECT_SLUG`
-
-### compose
-
 ```
-$ uffizzi project compose
+uffizzi project compose help
 ```
 
-That's the subcommand for project command. Use it to configure your compose file. This command has 3 subcommands `set`, `describe` and `unset`.
+### login
 
 ```
-$ uffizzi project compose set -f path_to_your_compose_file.yml
+uffizzi login --server=localhost:8080 --username=your@email.com
 ```
 
-Creates a new or updates existed compose file in uffizzi app for project specified in config file
+Log in to the app with the specified server.
 
-```
-$ uffizzi project compose describe
-```
+#### login options
 
-Shows the content of compose file related to project specified in config file if it's valid or validation errors if it's not
+| Option       | Aliase | Description               |
+| ------------ | ------ | ------------------------- |
+| `--username`     | `-u`   | Your email for logging in |
+| `--server` |        | The URL of the Uffizzi installation  |
 
-```
-$ uffizzi project compose unset
-```
+If server uses basic authentication you can specify options for it by setting `basic_auth_user` and `basic_auth_password` via `config set` command.
 
-Removes compose file related to project specified in config file
+### config
 
-You need to set project before use any of these commands via `uffizzi config set project YOUR_PROJECT_SLUG` command
+Use this command to configure your cli app.
 
-### compose options
+```
+$ uffizzi config
+```
 
-| Option   | Aliase | Description               |
-| -------- | ------ | ------------------------- |
-| `--file` | `-f`   | Path to your compose file |
+Launching interactive setup guide that sets the values for `server`, `username` and `project`
 
-### config
+### config subcommands
 
-Use this command to configure your cli app. This command has 4 subcommands `list`, `get`, `set`, and `delete`.
+This command has 4 subcommands `list`, `get`, `set`, and `delete`.
 
 ```
-$ uffizzi config list
+uffizzi config list
 ```
 
 Shows all options and their values from the config file.
 
 ```
-$ uffizzi config get OPTION
+uffizzi config get-value OPTION
 ```
 
 Shows the value of the specified option.
 
 ```
-$ uffizzi config set OPTION VALUE
+uffizzi config set OPTION VALUE
 ```
 
 Sets specified value for specified option. If a specified option already exists and has value it will be overwritten.
 
 ```
-$ uffizzi config delete OPTION
+uffizzi config unset OPTION
 ```
 
-Deletes specified option.
+Unsets specified option.
 
-### disconnect ###
+### project
 
 ```
-$ uffizzi disconnect CREDENTIAL_TYPE
+uffizzi project
 ```
 
-Deletes credential of specified type
-
-Supported credential types - `docker-hub`, `acr`, `ecr`, `gcr`
-
-## Generate manual
+Use this command to configure your projects. This command has 2 subcommands `list` and `compose`.
 
-In order to generate a manual, create a `.ronn` file having a name pattern like `uffizzi-{command-name}` (for example `uffizzi-project-compose`) in the `man` directory and run `bundle exec ronn man/{filename}.ronn` 
+```
+uffizzi project list
+```
 
-## Git workflow for the app:
+Shows all your projects' slugs
 
-1. Clone the repository and checkout to `develop` branch
+If you have only one project it will be added to your config file automatically, if there's more than one project you need to set up your project manually with the commands `uffizzi config set YOUR_PROJECT_SLUG` or `uffizzi project set-default YOUR_PROJECT_SLUG`
 
-2. Pull repository to ensure you have the latest changes
 ```
-git pull --rebase develop
+$ uffizzi project set-default PROJECT_SLUG
 ```
+Create a preview from a compose file.
+
+Sets the default project given with the given project slug. When set, all commands use this project as the default context unless overridden by the --project flag.
+
+### preview
+
+Create and manage previews
 
-3. Start new branch from `develop`
 ```
-git checkout -b feature/short_issue_description (e.g. feature/add_domain_settings)
+uffizzi preview create docker-compose.uffizzi.yml
 ```
+Create a preview from a compose file.
 
-4. Make changes you need for the feature, commit them to the repo
 ```
-git add .
-git commit -m 'short commit description' (e.g. git commit -m 'added domain settings')
-git push origin BRANCH_NAME
+uffizzi preview delete deployment-21
 ```
+Delete a preview with preview ID `deployment-21`.
 
-4. You already can create PR with develop branch as a target. Once the feature is ready let us know in the channel - we will review
+### disconnect
 
-5. Merge your feature to `qa` branch and push. Ensure your pipeline is successful
 ```
-git checkout qa
-git pull --rebase qa
-git merge --no-ff BRANCH_NAME
-git push origin qa
+uffizzi disconnect CREDENTIAL_TYPE
 ```
 
+Deletes credential of specified type
+
+Supported credential types - `docker-hub`, `acr`, `ecr`, `gcr`
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/UffizziCloud/uffizzi_cli.
+Bug reports and pull requests are welcome on GitHub at https://github.com/UffizziCloud/uffizzi_cli. See `CONTRIBUTING.md` in this repository.

data/config/uffizzi.rb

@@ -12,7 +12,7 @@ module Uffizzi
   end
 
   configure do |config|
-    config.hostname = 'http://web:7000'
+    config.server = 'http://web:7000'
     config.credential_types = {
       dockerhub: 'UffizziCore::Credential::DockerHub',
       azure: 'UffizziCore::Credential::Azure',
@@ -20,5 +20,6 @@ module Uffizzi
       amazon: 'UffizziCore::Credential::Amazon',
       github_container_registry: 'UffizziCore::Credential::GithubContainerRegistry',
     }
+    config.default_server = 'app.uffizzi.com'
   end
 end

data/exe/uffizzi

@@ -2,4 +2,4 @@
 # frozen_string_literal: true
 
 require 'uffizzi/cli'
-Uffizzi::CLI.start
+Uffizzi::Cli.start

data/lib/uffizzi/auth_helper.rb

@@ -5,14 +5,9 @@ module Uffizzi
     class << self
       def signed_in?
         ConfigFile.exists? &&
-          ConfigFile.option_exists?(:account_id) &&
-          ConfigFile.option_exists?(:cookie) &&
-          ConfigFile.option_exists?(:hostname)
-      end
-
-      def project_set?
-        ConfigFile.exists? &&
-          ConfigFile.option_exists?(:project)
+          ConfigFile.option_has_value?(:account_id) &&
+          ConfigFile.option_has_value?(:cookie) &&
+          ConfigFile.option_has_value?(:server)
       end
     end
   end

data/lib/uffizzi/cli/common.rb

@@ -2,11 +2,11 @@
 
 require 'open3'
 
-module Cli
-  class Common
+module Uffizzi
+  class Cli::Common
     class << self
       def show_manual(command_name)
-        manual_doc_path = "man/#{command_name}"
+        manual_doc_path = File.join(Uffizzi.root, "man/#{command_name}")
 
         Open3.pipeline("man #{manual_doc_path}")
       end

data/lib/uffizzi/cli/config.rb

@@ -4,29 +4,38 @@ require 'uffizzi'
 require 'uffizzi/clients/api/api_client'
 
 module Uffizzi
-  class CLI::Config < Thor
+  class Cli::Config < Thor
     include ApiClient
 
-    desc 'list', 'list'
+    desc 'list', 'Lists all options and their values from the config file'
     def list
       run('list')
     end
 
-    desc 'get [PROPERTY]', 'get'
-    def get(property)
+    desc 'get [PROPERTY]', 'Displays the value of the specified option'
+    def get_value(property)
       run('get', property)
     end
 
-    desc 'set [PROPERTY] [VALUE]', 'set'
+    desc 'set [PROPERTY] [VALUE]', 'Sets the value of the specified option'
     def set(property, value)
       run('set', property, value)
     end
 
-    desc 'delete [PROPERTY]', 'delete'
-    def delete(property)
-      run('delete', property)
+    desc 'unset [PROPERTY]', 'Deletes the value of the specified option'
+    def unset(property)
+      run('unset', property)
     end
 
+    desc 'setup', 'setup'
+    def setup
+      run('setup')
+    end
+
+    map('get-value' => :get_value)
+
+    default_task :setup
+
     private
 
     def run(command, property = nil, value = nil)
@@ -37,11 +46,26 @@ module Uffizzi
         handle_get_command(property)
       when 'set'
         handle_set_command(property, value)
-      when 'delete'
-        handle_delete_command(property)
+      when 'unset'
+        handle_unset_command(property)
+      when 'setup'
+        handle_setup_command
       end
     end
 
+    def handle_setup_command
+      Uffizzi.ui.say("Configure the default properties that will be used to authenticate with your \
+                      \nUffizzi API service and manage previews.\n")
+      server = Uffizzi.ui.ask('Server: ', default: Uffizzi.configuration.default_server.to_s)
+      username = Uffizzi.ui.ask('Username: ')
+      project = Uffizzi.ui.ask('Project: ')
+      ConfigFile.delete
+      ConfigFile.write_option(:server, server)
+      ConfigFile.write_option(:username, username)
+      ConfigFile.write_option(:project, project)
+      Uffizzi.ui.say('To login, run: uffizzi login')
+    end
+
     def handle_list_command
       ConfigFile.list
     end
@@ -55,10 +79,12 @@ module Uffizzi
 
     def handle_set_command(property, value)
       ConfigFile.write_option(property.to_sym, value)
+      Uffizzi.ui.say("Updated property [#{property}]")
     end
 
-    def handle_delete_command(property)
-      ConfigFile.delete_option(property.to_sym)
+    def handle_unset_command(property)
+      ConfigFile.unset_option(property.to_sym)
+      Uffizzi.ui.say("Unset property [#{property}]")
     end
   end
 end

data/lib/uffizzi/cli/connect.rb

@@ -3,29 +3,25 @@
 require 'uffizzi'
 
 module Uffizzi
-  class CLI::Connect
+  class Cli::Connect < Thor
     include ApiClient
 
-    def run(credential_type, credential_file_path)
-      case credential_type
-      when 'docker-hub'
-        handle_docker_hub
-      when 'acr'
-        handle_azure
-      when 'ecr'
-        handle_amazon
-      when 'ghcr'
-        handle_github_container_registry
-      when 'gcr'
-        handle_google(credential_file_path)
+    desc 'list-credentials', 'List existing credentials for an account'
+    def list_credentials
+      server = ConfigFile.read_option(:server)
+      response = fetch_credentials(server)
+      if ResponseHelper.ok?(response)
+        handle_list_credentials_success(response)
       else
-        Uffizzi.ui.say('Unsupported credential type.')
+        ResponseHelper.handle_failed_response(response)
       end
     end
 
-    private
+    desc 'docker-hub', 'Connect to Docker Hub (hub.docker.com)'
+    def docker_hub
+      type = Uffizzi.configuration.credential_types[:dockerhub]
+      check_credential_existance(type, 'docker-hub')
 
-    def handle_docker_hub
       username = Uffizzi.ui.ask('Username: ')
       password = Uffizzi.ui.ask('Password: ', echo: false)
 
@@ -35,8 +31,8 @@ module Uffizzi
         type: Uffizzi.configuration.credential_types[:dockerhub],
       }
 
-      hostname = ConfigFile.read_option(:hostname)
-      response = create_credential(hostname, params)
+      server = ConfigFile.read_option(:server)
+      response = create_credential(server, params)
 
       if ResponseHelper.created?(response)
         print_success_message('DockerHub')
@@ -45,7 +41,11 @@ module Uffizzi
       end
     end
 
-    def handle_azure
+    desc 'acr', 'Connect to Azure Container Registry (azurecr.io)'
+    def acr
+      type = Uffizzi.configuration.credential_types[:azure]
+      check_credential_existance(type, 'acr')
+
       registry_url = prepare_registry_url(Uffizzi.ui.ask('Registry Domain: '))
       username = Uffizzi.ui.ask('Docker ID: ')
       password = Uffizzi.ui.ask('Password/Access Token: ', echo: false)
@@ -54,11 +54,11 @@ module Uffizzi
         username: username,
         password: password,
         registry_url: registry_url,
-        type: Uffizzi.configuration.credential_types[:azure],
+        type: type,
       }
 
-      hostname = ConfigFile.read_option(:hostname)
-      response = create_credential(hostname, params)
+      server = ConfigFile.read_option(:server)
+      response = create_credential(server, params)
 
       if ResponseHelper.created?(response)
         print_success_message('ACR')
@@ -67,7 +67,11 @@ module Uffizzi
       end
     end
 
-    def handle_amazon
+    desc 'ecr', 'Connect to Amazon Elastic Container Registry'
+    def ecr
+      type = Uffizzi.configuration.credential_types[:amazon]
+      check_credential_existance(type, 'ecr')
+
       registry_url = prepare_registry_url(Uffizzi.ui.ask('Registry Domain: '))
       username = Uffizzi.ui.ask('Access key ID: ')
       password = Uffizzi.ui.ask('Secret access key: ', echo: false)
@@ -76,11 +80,11 @@ module Uffizzi
         username: username,
         password: password,
         registry_url: registry_url,
-        type: Uffizzi.configuration.credential_types[:amazon],
+        type: type,
       }
 
-      hostname = ConfigFile.read_option(:hostname)
-      response = create_credential(hostname, params)
+      server = ConfigFile.read_option(:server)
+      response = create_credential(server, params)
 
       if ResponseHelper.created?(response)
         print_success_message('ECR')
@@ -89,7 +93,11 @@ module Uffizzi
       end
     end
 
-    def handle_google(credential_file_path)
+    desc 'gcr', 'Connect to Google Container Registry (gcr.io)'
+    def gcr(credential_file_path = nil)
+      type = Uffizzi.configuration.credential_types[:google]
+      check_credential_existance(type, 'gcr')
+
       return Uffizzi.ui.say('Path to google service account key file wasn\'t specified.') if credential_file_path.nil?
 
       begin
@@ -100,11 +108,11 @@ module Uffizzi
 
       params = {
         password: credential_content,
-        type: Uffizzi.configuration.credential_types[:google],
+        type: type,
       }
 
-      hostname = ConfigFile.read_option(:hostname)
-      response = create_credential(hostname, params)
+      server = ConfigFile.read_option(:server)
+      response = create_credential(server, params)
 
       if ResponseHelper.created?(response)
         print_success_message('GCR')
@@ -113,26 +121,35 @@ module Uffizzi
       end
     end
 
-    def handle_github_container_registry
+    desc 'ghcr', 'Connect to GitHub Container Registry (ghcr.io)'
+    def ghcr
+      type = Uffizzi.configuration.credential_types[:github_container_registry]
+      check_credential_existance(type, 'gchr')
+
       username = Uffizzi.ui.ask('Github Username: ')
       password = Uffizzi.ui.ask('Access Token: ', echo: false)
 
       params = {
         username: username,
         password: password,
-        type: Uffizzi.configuration.credential_types[:github_container_registry],
+        type: type,
       }
 
-      hostname = ConfigFile.read_option(:hostname)
-      response = create_credential(hostname, params)
+      server = ConfigFile.read_option(:server)
+      response = create_credential(server, params)
 
       if ResponseHelper.created?(response)
-        print_success_message('GitHub Container Registry')
+        print_success_message('GHCR')
       else
         ResponseHelper.handle_failed_response(response)
       end
     end
 
+    map 'list-credentials' => 'list_credentials'
+    map 'docker-hub' => 'docker_hub'
+
+    private
+
     def prepare_registry_url(registry_url)
       return registry_url if registry_url.match?(/^(?:http(s)?:\/\/)/)
 
@@ -142,5 +159,35 @@ module Uffizzi
     def print_success_message(connection_name)
       Uffizzi.ui.say("Successfully connected to #{connection_name}")
     end
+
+    def check_credential_existance(type, connection_name)
+      server = ConfigFile.read_option(:server)
+      response = check_credential(server, type)
+      return if ResponseHelper.ok?(response)
+
+      message = "Credentials of type #{connection_name} already exist for this account. " \
+      "To remove them, run $ uffizzi disconnect #{connection_name}."
+      raise Uffizzi::Error.new(message)
+    end
+
+    def handle_list_credentials_success(response)
+      credentials = response[:body][:credentials]
+      credentials.each do |credential|
+        Uffizzi.ui.say(credential_readable_name(credential))
+      end
+    end
+
+    def credential_readable_name(credential)
+      map = {
+        'UffizziCore::Credential::DockerHub' => 'docker-hub',
+        'UffizziCore::Credential::Github' => 'github',
+        'UffizziCore::Credential::Azure' => 'acr',
+        'UffizziCore::Credential::Amazon' => 'ecr',
+        'UffizziCore::Credential::GithubContainerRegistry' => 'ghcr',
+        'UffizziCore::Credential::Google' => 'gcr',
+      }
+
+      map[credential]
+    end
   end
 end