jenkins2 0.1.0 → 1.0.0

data/lib/jenkins2/cli/credentials.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module Jenkins2
+	class CLI
+		class CreateCredentialsByXml < CLI
+			def self.description
+				'Create credential by reading stdin as an XML configuration.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).create($stdin.read)
+			end
+		end
+
+		class CreateCredentialsDomainByXml < CLI
+			def self.description
+				'Create credential domain by reading stdin as an XML configuration.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).create_domain($stdin.read)
+			end
+		end
+
+		class DeleteCredentials < CLI
+			def self.description
+				'Delete credentials.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+				parser.on '--credential ID', 'Credential id.' do |c|
+					options[:credential] = c
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain credential]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).
+					credential(options[:credential]).delete
+			end
+		end
+
+		class DeleteCredentialsDomain < CLI
+			def self.description
+				'Delete credentials domain.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).delete
+			end
+		end
+
+		class GetCredentialsAsXml < CLI
+			def self.description
+				'Get a credential as XML (secrets redacted).'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+				parser.on '--credential ID', 'Credential id.' do |c|
+					options[:credential] = c
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain credential]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).
+					credential(options[:credential]).config_xml
+			end
+		end
+
+		class GetCredentialsDomainAsXml < CLI
+			def self.description
+				'Get credentials domain as XML.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).config_xml
+			end
+		end
+
+		class ListCredentials < CLI
+			def self.description
+				'Lists credentials in a specific store.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+			end
+
+			def mandatory_arguments
+				super + [:store]
+			end
+
+			def run
+				jc.credentials.store(options[:store], depth: 2).domains.to_h.collect do |_, v|
+					"Domain: #{v.displayName}\n" +
+						v.credentials.collect do |crd|
+							"#{crd.id} - #{crd.displayName}"
+						end.join("\n")
+				end.join("\n")
+			end
+		end
+
+		class UpdateCredentialsByXml < CLI
+			def self.description
+				'Update credentials by XML.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+				parser.on '--credential ID', 'Credential id.' do |c|
+					options[:credential] = c
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain credential]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).
+					credential(options[:credential]).update($stdin.read)
+			end
+		end
+
+		class UpdateCredentialsDomainByXml < CLI
+			def self.description
+				'Update credentials domain by XML.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '--store STORE', 'Store id. (e.g. "system")' do |s|
+					options[:store] = s
+				end
+				parser.on '--domain DOMAIN', 'Domain id. (e.g. "_")' do |d|
+					options[:domain] = d
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[store domain]
+			end
+
+			def run
+				jc.credentials.store(options[:store]).domain(options[:domain]).update($stdin.read)
+			end
+		end
+	end
+end

data/lib/jenkins2/cli/job.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Jenkins2
+	class CLI
+		class ListJobs < CLI
+			def self.description
+				'Lists all jobs in a specific view or item group.'
+			end
+
+			private
+
+			def add_options
+				parser.separator 'Optional arguments:'
+				parser.on '-n', '--name NAME', 'Name of the view. Default - all' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run; end
+		end
+
+		class CopyJob < CLI
+			def self.description
+				'Copies a job.'
+			end
+
+			private
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-f', '--from NAME', 'Name of the job to copy.' do |f|
+					options[:from] = f
+				end
+				parser.on '-n', '--name NAME', 'Name of the new job, to be created.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def mandatory_arguments
+				super + %i[name from]
+			end
+
+			def run
+				jc.job(options[:name]).copy(options[:from])
+			end
+		end
+	end
+end

data/lib/jenkins2/cli/nodes.rb

@@ -0,0 +1,233 @@
+# frozen_string_literal: true
+
+module Jenkins2
+	class CLI
+		class ConnectNode < CLI
+			def self.description
+				'Reconnect node(s).'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name X,Y,..', Array, 'Slave name, or "(master)" for master, '\
+					'comma-separated list is supported.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				options[:name].all? do |name|
+					jc.computer(name).launch_agent
+				end
+			end
+		end
+
+		class CreateNode < CLI
+			def self.description
+				'Creates a new node by reading stdin for an XML configuration.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				jc.computer(options[:name]).create and
+					jc.computer(options[:name]).update($stdin.read)
+			end
+		end
+
+		class DeleteNode < CLI
+			def self.description
+				'Deletes node(s).'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name X,Y,..', Array, 'Names of nodes to delete.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				options[:name].all? do |name|
+					jc.computer(name).delete
+				end
+			end
+		end
+
+		class DisconnectNode < CLI
+			def self.description
+				'Disconnects node(s).'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name X,Y,..', Array, 'Slave name, or "(master)" for master, '\
+					'comma-separated list is supported.' do |n|
+					options[:name] = n
+				end
+				parser.separator 'Optional arguments:'
+				parser.on '-m', '--message TEXT', 'Record the reason about why you are disconnecting the'\
+					' node(s).' do |m|
+					options[:message] = m
+				end
+			end
+
+			def run
+				options[:name].all? do |name|
+					jc.computer(name).disconnect(options[:message])
+				end
+			end
+		end
+
+		class GetNode < CLI
+			def self.description
+				'Dumps the node definition XML to stdout.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				jc.computer(options[:name]).config_xml
+			end
+		end
+
+		class ListNode < CLI
+			def self.description
+				'Outputs the node list.'
+			end
+
+			def run
+				jc.computer.computer.collect(&:displayName).join("\n")
+			end
+		end
+
+		class ListOnlineNode < CLI
+			def self.description
+				'Outputs the online node list.'
+			end
+
+			def run
+				jc.computer.computer.delete_if{|i| i.offline or i.temporarilyOffline }.
+					collect(&:displayName).join("\n")
+			end
+		end
+
+		class OfflineNode < CLI
+			def self.description
+				'Stop using a node for performing builds temporarily, until the next "online-node" '\
+				'command.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node or "(master)" for master.' do |n|
+					options[:name] = n
+				end
+				parser.separator 'Optional arguments:'
+				parser.on '-m', '--message TEXT', 'Record the reason about why you are disconnecting the'\
+					' node.' do |m|
+					options[:message] = m
+				end
+			end
+
+			def run
+				return if jc.computer(options[:name]).temporarilyOffline
+				jc.computer(options[:name]).toggle_offline(options[:message])
+			end
+		end
+
+		class OnlineNode < CLI
+			def self.description
+				'Resume using a node for performing builds, to cancel out the earlier "offline-node" '\
+				'command.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node or "(master)" for master.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				return unless jc.computer(options[:name]).temporarilyOffline
+				jc.computer(options[:name]).toggle_offline
+			end
+		end
+
+		class UpdateNode < CLI
+			def self.description
+				'Updates the node definition XML from stdin. The opposite of the get-node command.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node.' do |n|
+					options[:name] = n
+				end
+			end
+
+			def run
+				jc.computer(options[:name]).update($stdin.read)
+			end
+		end
+
+		class WaitNodeOffline < CLI
+			def self.description
+				'Wait for a node to become offline.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node.' do |n|
+					options[:name] = n
+				end
+				parser.separator 'Optional arguments:'
+				parser.on '-w', '--wait MINUTES', Integer, 'Maximum number of minutes to wait. Default is '\
+					'60.' do |w|
+					options[:wait] = w
+				end
+			end
+
+			def run
+				Jenkins2::Util.wait(max_wait_minutes: options[:wait]) do
+					!jc.computer(options[:name]).online?
+				end
+			end
+		end
+
+		class WaitNodeOnline < CLI
+			def self.description
+				'Wait for a node to become online.'
+			end
+
+			def add_options
+				parser.separator 'Mandatory arguments:'
+				parser.on '-n', '--name NAME', 'Name of the node.' do |n|
+					options[:name] = n
+				end
+				parser.separator 'Optional arguments:'
+				parser.on '-w', '--wait MINUTES', Integer, 'Maximum number of minutes to wait. Default is '\
+					'60.' do |w|
+					options[:wait] = w
+				end
+			end
+
+			def run
+				Jenkins2::Util.wait(max_wait_minutes: options[:wait]) do
+					jc.computer(options[:name]).online?
+				end
+			end
+		end
+	end
+end