sct 0.1.17 → 0.1.22

Sign up to get free protection for your applications and to get access to all the features.
Files changed (65) hide show
  1. checksums.yaml +4 -4
  2. data/bin/sct +3 -4
  3. data/{.DS_Store → cluster/lib/.DS_Store} +0 -0
  4. data/cluster/lib/cluster.rb +6 -0
  5. data/cluster/lib/cluster/commands_generator.rb +109 -0
  6. data/cluster/lib/cluster/module.rb +7 -0
  7. data/{lib/sct → cluster/lib/cluster/resources}/.DS_Store +0 -0
  8. data/{resources → cluster/lib/cluster/resources}/corefile.yml +0 -0
  9. data/{lib/sct/commands/cluster.rb → cluster/lib/cluster/runner.rb} +160 -145
  10. data/{lib → sct/lib}/.DS_Store +0 -0
  11. data/sct/lib/sct.rb +17 -0
  12. data/sct/lib/sct/.DS_Store +0 -0
  13. data/sct/lib/sct/cli_tools_distributor.rb +50 -0
  14. data/{lib → sct/lib}/sct/command.rb +0 -0
  15. data/{lib → sct/lib}/sct/commands/hostfile.rb +7 -23
  16. data/sct/lib/sct/commands/init.rb +37 -0
  17. data/sct/lib/sct/commands/mysqlproxy.rb +20 -0
  18. data/sct/lib/sct/commands_generator.rb +56 -0
  19. data/sct/lib/sct/tools.rb +12 -0
  20. data/sct/lib/sct/version.rb +3 -0
  21. data/sct_core/lib/.DS_Store +0 -0
  22. data/sct_core/lib/sct_core.rb +14 -0
  23. data/sct_core/lib/sct_core/.DS_Store +0 -0
  24. data/sct_core/lib/sct_core/command_executor.rb +104 -0
  25. data/{lib/sct → sct_core/lib/sct_core}/config.rb +3 -3
  26. data/sct_core/lib/sct_core/core_ext/string.rb +9 -0
  27. data/{lib/sct/setup/helpers.rb → sct_core/lib/sct_core/helper.rb} +2 -2
  28. data/sct_core/lib/sct_core/module.rb +0 -0
  29. data/sct_core/lib/sct_core/sct_pty.rb +53 -0
  30. data/sct_core/lib/sct_core/ui/implementations/shell.rb +129 -0
  31. data/sct_core/lib/sct_core/ui/interface.rb +120 -0
  32. data/sct_core/lib/sct_core/ui/ui.rb +26 -0
  33. data/sct_core/lib/sct_core/update_checker/update_checker.rb +76 -0
  34. data/shell/README.md +0 -0
  35. data/shell/lib/shell.rb +3 -0
  36. data/{lib/sct → shell/lib/shell}/ClassLevelInheritableAttributes.rb +0 -0
  37. data/shell/lib/shell/commands_generator.rb +14 -0
  38. data/{lib/sct → shell/lib/shell}/docker/composer.rb +4 -3
  39. data/{lib/sct → shell/lib/shell}/docker/docker.rb +7 -10
  40. data/{lib/sct → shell/lib/shell}/docker/php.rb +3 -2
  41. data/{lib/sct → shell/lib/shell}/docker/yarn.rb +4 -3
  42. data/shell/lib/shell/module.rb +9 -0
  43. data/shell/lib/shell/runner.rb +34 -0
  44. data/shell/lib/shell/tools.rb +7 -0
  45. metadata +126 -53
  46. data/.gitignore +0 -12
  47. data/.gitlab/merge_request_templates/DefinitionOfDone.md +0 -14
  48. data/.rspec +0 -3
  49. data/.travis.yml +0 -7
  50. data/CODE_OF_CONDUCT.md +0 -74
  51. data/Gemfile +0 -4
  52. data/Gemfile.lock +0 -44
  53. data/LICENSE.txt +0 -21
  54. data/README.md +0 -134
  55. data/Rakefile +0 -6
  56. data/lib/sct.rb +0 -61
  57. data/lib/sct/command_interface.rb +0 -18
  58. data/lib/sct/command_option.rb +0 -14
  59. data/lib/sct/commands/composer.rb +0 -29
  60. data/lib/sct/commands/init.rb +0 -51
  61. data/lib/sct/commands/mysqlproxy.rb +0 -38
  62. data/lib/sct/commands/php.rb +0 -37
  63. data/lib/sct/commands/yarn.rb +0 -26
  64. data/lib/sct/version.rb +0 -3
  65. data/sct.gemspec +0 -40
@@ -1,21 +0,0 @@
1
- The MIT License (MIT)
2
-
3
- Copyright (c) 2020 Reshad Farid
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in
13
- all copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
- THE SOFTWARE.
data/README.md DELETED
@@ -1,134 +0,0 @@
1
- # SCT
2
- The **SCT** command line tool helps developers set up and maintain a Kubernetes (k8s) cluster on their development machine which closely resembles the production setup.
3
-
4
- The tool is geared towards the implementation of a local development environment in compliance with the [*Visma Cloud Delivery Model*](https://www.visma.com/blog/our-large-scale-devops-transformation/) (SCT) to be deployed on *Google Cloud Services*.
5
-
6
- The SCT tool is a collection of commands that can be run from your local development environment. These commands will take care of some steps necessary to initialize the development environment, but also of some recurring tasks to keep this environment going on a daily base.
7
-
8
- This README will provide an installation guide, an overview of the available commands and a brief guide for developers that need to contribute to the **SCT** CLI tool.
9
-
10
- The tool is written in Ruby and is meant to run on *Windows, Linux and Mac* environments.
11
-
12
- ## Installation
13
-
14
- 1) Open a terminal or bash window and make sure [**Ruby**](https://www.ruby-lang.org/en/documentation/installation/) is installed on your machine with _version >= 2.6.*_
15
-
16
- $ which ruby
17
- $ ruby --version
18
-
19
- 2) As this Ruby Gem is not yet published, you will need to install the *SCT* tool from this repository and use Ruby [**bundler**](https://bundler.io/) to manage dependencies.
20
-
21
- $ gem install bundler
22
-
23
- 3) Navigate to a (new) folder where you want the SCT code, and clone this repository:
24
-
25
- $ git clone https://github.com/reshadf/sct.git
26
-
27
- 4) Then let **bundler** manage the dependencies:
28
-
29
- $ bundle
30
-
31
- 5) And let **gem** create a binary:
32
-
33
- $ gem install sct
34
-
35
- 6) Now, the **sct** tool is available anywhere from the command line
36
-
37
- $ sct --help
38
-
39
-
40
- ## Usage
41
-
42
- SCT offers a number of commands to help developers set up a local development environment for Visma Cloud To get an overview of what **sct** can do, run
43
-
44
- $ sct --help
45
-
46
- To initialize a **sct** configuration file
47
-
48
- $ sct init
49
-
50
- To patch the hostfile with the local IP of the k8s cluster:
51
-
52
- $ sct hostfile
53
-
54
- To add the secret for the MySQL proxy:
55
-
56
- $ sct mysql_proxy
57
-
58
-
59
- ## Development
60
-
61
- For development of the **sct** tool, the installation needs to be a bit different.
62
-
63
- Repeat steps 1-3 from the installation instruction above.
64
-
65
- 4) We will use [**rake**](https://github.com/ruby/rake) as a Ruby develoment tool for running tests and generating binaries:
66
-
67
- $ gem install rake
68
-
69
- 5) Use the setup script from the repo to install dependencies:
70
-
71
- $ bin/setup
72
-
73
- 5) Do tests to make sure everything works fine before you start:
74
-
75
- $ rake spec
76
-
77
- 6) Install dependency gems:
78
-
79
- $ bundle exec rake install
80
-
81
- 7) Your development environment is now ready. After you have made edits to the code, you can generate a new binary to test the code like this:
82
-
83
- $ rake install
84
-
85
- 8) You can then run the binary directly from the command line:
86
-
87
- $ sct --help
88
-
89
- ### Development tips
90
-
91
- - To release a new version, update the version number in `version.rb`, and then run:
92
-
93
- $ bundle exec rake release
94
-
95
- This will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
96
-
97
- ### Adding commands
98
-
99
- Adding a new command is as simple as adding a new 'Command' Class to the *lib/sct/commands* folder. As long as you implement the constants and methods of *lib/sct/command_interface.rb*, your new Command will automatically appear in the CLI Help and can be called. Use the *lib/sct/command_option.rb* to define command options. Examples of Command Classes can be found inside the *lib/sct/commands* folder.
100
-
101
-
102
- ## Contributing
103
-
104
- Bug reports and pull requests are welcome on GitHub at https://gitlab.com/proactive-software/packages/sct. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
105
-
106
- ## Releasing
107
-
108
- #### Ownership
109
- Owners of the Ruby Gem project are able to release a new version. You can check the ownership status at https://rubygems.org/gems/sct. If you are an owner you can continue with the following steps. If not you may request to become an owner, or ask an existing owner to do the release for you.
110
-
111
- #### Authentication
112
- Owners should update their credentials once before they can actually release new versions. The steps to do this are:
113
- ```$bash
114
- curl -u [YOUR-RUBYGEM-USERNAME] https://rubygems.org/api/v1/api_key.yaml > ~/.gem/credentials
115
- chmod 0600 ~/.gem/credentials
116
- ```
117
-
118
- ### Release steps
119
- #### Update version
120
- Before releasing you are required to update the version of the new release. You can do this manually by incrementing the value in the file `./sct/lib/sct/version.rb`. After this you need to commit this change and push it to the master branch.
121
-
122
- #### Release
123
- You are now ready to release. You can do this with a simple command in the SCT repository's root directory:
124
- ```$xslt
125
- rake release
126
- ```
127
-
128
- ## License
129
-
130
- The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
131
-
132
- ## Code of Conduct
133
-
134
- Everyone interacting in the Sct project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://gitlab.com/proactive-software/packages/sct/blob/master/CODE_OF_CONDUCT.md).
data/Rakefile DELETED
@@ -1,6 +0,0 @@
1
- require "bundler/gem_tasks"
2
- require "rspec/core/rake_task"
3
-
4
- RSpec::Core::RakeTask.new(:spec)
5
-
6
- task :default => :spec
data/lib/sct.rb DELETED
@@ -1,61 +0,0 @@
1
- require 'sct'
2
- require "sct/config"
3
- require 'sct/command'
4
- require "sct/version"
5
- require 'colored'
6
- require 'commander'
7
-
8
- module Sct
9
- class SctCore
10
-
11
- program :name, 'sct'
12
- program :version, Sct::VERSION
13
- program :summary, 'CLI helper tool for local SCT development'
14
- program :description, 'SCT is a CLI tool for developers using the Visma Continuous Deployment Model in conjunction with the Google Cloud Platform (GCP). It provides multiple command to set up and maintain a kubernetes cluster on a machine for local development'
15
-
16
- def self.take_off(cmds)
17
- self.new.run
18
- cmds.each { |cmd| registerCommand(cmd) }
19
- end
20
-
21
- def run
22
-
23
- end
24
-
25
- def self.registerCommand(cmd)
26
- # validate Command Class
27
- if cmd.class != Class ||
28
- !cmd.name.end_with?('Command')
29
- return
30
- end
31
-
32
- # validate if Command is meant to be public
33
- if !cmd::IS_PUBLIC_COMMAND
34
- return
35
- end
36
-
37
- # register public Commands as CLI command
38
- command self.deduceCommandNameFromClass(cmd) do |c|
39
- c.syntax = cmd::SYNTAX
40
- c.summary = cmd::SUMMARY
41
- c.description = cmd::DESCRIPTION
42
- c.example cmd::EXAMPLE_DESCRIPTION, cmd::EXAMPLE
43
- cmd::OPTIONS.each { |option| c.option option.name, option.type, option.description }
44
- c.action do |args, options|
45
- cmd.new.execute(args, options)
46
- end
47
- end
48
- end
49
-
50
- # retrieves cli command-name from Command's full Class name
51
- def self.deduceCommandNameFromClass(c)
52
- name = c.name
53
- if name.include?('::')
54
- name = name.partition('::')[2]
55
- end
56
- # TODO replace camel-case capitals with '-'
57
- return name.chomp('Command').downcase
58
- end
59
-
60
- end
61
- end
@@ -1,18 +0,0 @@
1
- require 'class_interface'
2
-
3
- class CommandInterface
4
- IS_PUBLIC_COMMAND = true | false
5
- SYNTAX = String
6
- SUMMARY = String
7
- DESCRIPTION = String
8
- EXAMPLE = String
9
- EXAMPLE_DESCRIPTION = String
10
- OPTIONS = Array
11
-
12
- def initialize
13
- end
14
-
15
- def execute(args, options)
16
- end
17
-
18
- end
@@ -1,14 +0,0 @@
1
- module Sct
2
-
3
- class CommandOption
4
- attr_reader :name, :type, :description
5
-
6
- def initialize(name, type, description)
7
- @name = name
8
- @type = type
9
- @description = description
10
- end
11
-
12
- end
13
-
14
- end
@@ -1,29 +0,0 @@
1
- require 'sct/command_interface'
2
- require 'sct/command_option'
3
-
4
- module Sct
5
-
6
- class ComposerCommand
7
-
8
- IS_PUBLIC_COMMAND = true
9
- SYNTAX = 'sct composer'
10
- SUMMARY = 'Run composer commands through SCT'
11
- EXAMPLE = 'sct composer install'
12
- EXAMPLE_DESCRIPTION = 'sct composer install will update the project with the latest dependencies'
13
- DESCRIPTION = "sct will run composer commands through the local docker installation"
14
-
15
- OPTIONS = [
16
- CommandOption.new("--verbose", nil, "Increase verbosity of messages."),
17
- CommandOption.new("--require STRING", String, "Package to require with a version constraint. Should be in format foo/bar:1.0.0"),
18
- CommandOption.new("--require-dev STRING", String, "Development requirements, see --require."),
19
- CommandOption.new("-V", nil, "Display this application version.")
20
- ]
21
-
22
- def execute(args, options)
23
- require "sct/docker/composer"
24
- Sct::Composer.exec(ARGV[1..(ARGV.length+1)])
25
- end
26
-
27
- implements CommandInterface
28
- end
29
- end
@@ -1,51 +0,0 @@
1
- require 'sct/command_interface'
2
- require 'highline'
3
-
4
- module Sct
5
-
6
- class InitCommand
7
-
8
- IS_PUBLIC_COMMAND = true
9
- SYNTAX = 'sct init'
10
- SUMMARY = 'Initialize a base configuration file for sct'
11
- EXAMPLE = 'sct init'
12
- EXAMPLE_DESCRIPTION = 'sct init will create a configuration file'
13
- DESCRIPTION = "sct init will create a configuration file"
14
-
15
- OPTIONS = []
16
-
17
- def initialize
18
- end
19
-
20
- def execute(args, options)
21
-
22
- Sct::Config.dir
23
-
24
- cli = HighLine.new
25
-
26
- email = cli.ask("What is your email address?") { |q|
27
- q.validate = URI::MailTo::EMAIL_REGEXP
28
- }
29
-
30
- cloud_proxy_path = cli.ask("What is the path of your cloud proxy json credentials?") { |q|
31
- q.default = "~/.config/gcloud/application_default_credentials.json"
32
- }
33
-
34
- contents = ""
35
- contents << "email=#{email}\n"
36
- contents << "cloud-proxy-path=#{File.expand_path(cloud_proxy_path)}\n"
37
-
38
- if !File.directory?(Sct::Config.dir)
39
- FileUtils.mkdir_p(Sct::Config.dir)
40
- end
41
-
42
- File.write(Sct::Config.path, contents)
43
-
44
- puts "Generated config file at #{Sct::Config.path}"
45
- end
46
-
47
- implements CommandInterface
48
-
49
- end
50
-
51
- end
@@ -1,38 +0,0 @@
1
- require 'sct/command_interface'
2
- require 'sct/command_option'
3
- require "sct/config"
4
- require "sct/setup/helpers"
5
-
6
- module Sct
7
-
8
- class Mysql_proxyCommand
9
-
10
- DEFAULT_SECRET_NAME = "gcloud-credentials"
11
-
12
- IS_PUBLIC_COMMAND = true
13
- SYNTAX = 'sct mysql_proxy'
14
- SUMMARY = 'adds a secret for the mysql proxy'
15
- DESCRIPTION = ""
16
- EXAMPLE = ""
17
- EXAMPLE_DESCRIPTION = ""
18
- OPTIONS = []
19
-
20
- def execute(args, options)
21
-
22
- return puts "SCT has not been initialized. Run 'sct init' first.".red unless Sct::Config.exists
23
-
24
- path = Sct::Config.get('cloud-proxy-path')
25
-
26
- system("kubectl delete secret gcloud-credentials")
27
- system("kubectl create secret generic gcloud-credentials --from-file=#{path}")
28
-
29
- puts "Authenticated with secret-name: '#{DEFAULT_SECRET_NAME}'".green
30
-
31
- return true
32
- end
33
-
34
- implements CommandInterface
35
-
36
- end
37
-
38
- end
@@ -1,37 +0,0 @@
1
- require 'sct/command_interface'
2
- require 'sct/command_option'
3
-
4
- module Sct
5
-
6
- class PhpCommand
7
-
8
- IS_PUBLIC_COMMAND = true
9
- SYNTAX = 'sct php'
10
- SUMMARY = 'Run php commands through SCT'
11
- EXAMPLE = 'sct php -r "echo \'Hello World!\';"'
12
- EXAMPLE_DESCRIPTION = 'sct php -r will execute a command directly through the php interpreter'
13
- DESCRIPTION = "sct will run php commands through the local docker installation"
14
-
15
- OPTIONS = [
16
- CommandOption.new("-r", String, "Run php code directy through the interpreter"),
17
- CommandOption.new("-V", nil, "Get the current php version. Note that it's a capital V. The lowercase v will return the SCT tool version"),
18
- ]
19
-
20
- def execute(args, options)
21
- require "sct/docker/php"
22
-
23
- # Workaround for the version option being caught by the SCT tool itself
24
- args=ARGV[1..(ARGV.length+1)].map { |arg| arg == '-V' ? arg = '-v' : arg}
25
-
26
- # Another workaround for the -r option to add quotes around the value
27
- if args.include? '-r'
28
- codeIndex = args.index('-r') + 1
29
- args[codeIndex] = "\"#{args[codeIndex]}\""
30
- end
31
-
32
- Sct::Php.exec(args)
33
- end
34
-
35
- implements CommandInterface
36
- end
37
- end
@@ -1,26 +0,0 @@
1
- require 'sct/command_interface'
2
- require 'sct/command_option'
3
-
4
- module Sct
5
-
6
- class YarnCommand
7
-
8
- IS_PUBLIC_COMMAND = true
9
- SYNTAX = 'sct yarn'
10
- SUMMARY = 'Run yarn commands through SCT'
11
- EXAMPLE = 'sct yarn dev'
12
- EXAMPLE_DESCRIPTION = 'sct yarn dev will start the dev installation of the current project'
13
- DESCRIPTION = "sct will run yarn commands through the local docker installation"
14
-
15
- OPTIONS = [
16
- CommandOption.new("--port PORTNUMBER", Integer, "The portnumber on which the server will be deployed")
17
- ]
18
-
19
- def execute(args, options)
20
- require "sct/docker/yarn"
21
- Sct::Yarn.exec(ARGV[1..(ARGV.length+1)])
22
- end
23
-
24
- implements CommandInterface
25
- end
26
- end