Как использовать шаг свойств трубопровода Jenkins?

Question

Я изучаю возможности Jenkins Pipeline: Multibranch. Говорят, что недавно введенный шаг properties может быть полезен там, но я не могу понять, как он работает и какова его цель.

Его намек на сообщение, кажется, не очень понятно:

обновляет свойства задания, которое запускает этот шаг. В основном полезно для многобрендовых рабочих процессов, так что сам Jenkinsfile может кодировать то, что в противном случае было бы статической конфигурацией заданий.

Так что я создал новый трубопровод с этим как скрипт (вставленный непосредственно в Дженкинс не в SCM):

properties [[$class: 'ParametersDefinitionProperty', 
    parameterDefinitions: [[$class: 'StringParameterDefinition', 
     defaultValue: '', description: '', name: 'PARAM1']] 
]] 

Я выбежала его и ничего не произошло, работа не получила новый параметр и даже если бы это произошло, я не понимаю, зачем мне это нужно. Может ли кто-нибудь объяснить это?

UPDATE1: Я попытался поместить фиктивный конвейер со свойствами, входящими в мой репозиторий git, а затем сконфигурировал работу с мультибрендом.

println 1 
properties [[$class: 'ParametersDefinitionProperty', parameterDefinitions: [[$class: 'StringParameterDefinition', defaultValue: 'str1', description: '', name: 'PARAM1']]], [$class: 'RebuildSettings', autoRebuild: false, rebuildDisabled: false]] 
println 2 

Он нашел свой филиал, создал работу, но сборка не удалось с:

groovy.lang.MissingPropertyException: No such property: properties for class: groovy.lang.Binding 
at groovy.lang.Binding.getVariable(Binding.java:62) 
at org.jenkinsci.plugins.scriptsecurity.sandbox.groovy.SandboxInterceptor.onGetProperty(SandboxInterceptor.java:185) 
at org.kohsuke.groovy.sandbox.impl.Checker$4.call(Checker.java:241) 
at org.kohsuke.groovy.sandbox.impl.Checker.checkedGetProperty(Checker.java:238) 
at com.cloudbees.groovy.cps.sandbox.SandboxInvoker.getProperty(SandboxInvoker.java:23) 
at com.cloudbees.groovy.cps.impl.PropertyAccessBlock.rawGet(PropertyAccessBlock.java:17) 
at WorkflowScript.run(WorkflowScript:2) 
at ___cps.transform___(Native Method) 
at com.cloudbees.groovy.cps.impl.PropertyishBlock$ContinuationImpl.get(PropertyishBlock.java:62) 
at com.cloudbees.groovy.cps.LValueBlock$GetAdapter.receive(LValueBlock.java:30) 
at com.cloudbees.groovy.cps.impl.PropertyishBlock$ContinuationImpl.fixName(PropertyishBlock.java:54) 
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) 
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57) 
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) 
at java.lang.reflect.Method.invoke(Method.java:601) 
at com.cloudbees.groovy.cps.impl.ContinuationPtr$ContinuationImpl.receive(ContinuationPtr.java:72) 
at com.cloudbees.groovy.cps.impl.ConstantBlock.eval(ConstantBlock.java:21) 
at com.cloudbees.groovy.cps.Next.step(Next.java:58) 
at com.cloudbees.groovy.cps.Continuable.run0(Continuable.java:154) 
at org.jenkinsci.plugins.workflow.cps.SandboxContinuable.access$001(SandboxContinuable.java:19) 
at org.jenkinsci.plugins.workflow.cps.SandboxContinuable$1.call(SandboxContinuable.java:33) 
at org.jenkinsci.plugins.workflow.cps.SandboxContinuable$1.call(SandboxContinuable.java:30) 
at org.jenkinsci.plugins.scriptsecurity.sandbox.groovy.GroovySandbox.runInSandbox(GroovySandbox.java:106) 
at org.jenkinsci.plugins.workflow.cps.SandboxContinuable.run0(SandboxContinuable.java:30) 
at org.jenkinsci.plugins.workflow.cps.CpsThread.runNextChunk(CpsThread.java:164) 
at org.jenkinsci.plugins.workflow.cps.CpsThreadGroup.run(CpsThreadGroup.java:277) 
at org.jenkinsci.plugins.workflow.cps.CpsThreadGroup.access$000(CpsThreadGroup.java:77) 
at org.jenkinsci.plugins.workflow.cps.CpsThreadGroup$2.call(CpsThreadGroup.java:186) 
at org.jenkinsci.plugins.workflow.cps.CpsThreadGroup$2.call(CpsThreadGroup.java:184) 
at org.jenkinsci.plugins.workflow.cps.CpsVmExecutorService$2.call(CpsVmExecutorService.java:47) 
at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334) 
at java.util.concurrent.FutureTask.run(FutureTask.java:166) 
at hudson.remoting.SingleLaneExecutorService$1.run(SingleLaneExecutorService.java:112) 
at jenkins.util.ContextResettingExecutorService$1.run(ContextResettingExecutorService.java:28) 
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:471) 
at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334) 
at java.util.concurrent.FutureTask.run(FutureTask.java:166) 
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1110) 
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:603) 
at java.lang.Thread.run(Thread.java:722) 

UPDATE2: когда я ставлю тот же сценарий (как в UPD1) обратно в Jenkins и запускает его, он попросил новое разрешение method groovy.lang.GroovyObject getProperty java.lang.String. Я его одобрил, сборка стала зеленой, однако никаких изменений в конфигурации задания не появилось.

Мой окр является: Дженкинс 1.625.3, трубопроводный + многоотраслевая 1,13

Answer 1

Использование properties с явным синтаксисом метод будет работать, а именно:
properties([ ... ]), а не properties [ ... ]

В качестве альтернативы, он будет работать без если вы указать имя параметра, например:

properties properties: [ ... ] 

Например, определяющие три свойства так же легко, как:

properties([ 
    parameters([ 
    string(name: 'submodule', defaultValue: ''), 
    string(name: 'submodule_branch', defaultValue: ''), 
    string(name: 'commit_sha', defaultValue: ''), 
    ]) 
]) 

/* Accessible then with : params.submodule, params.submodule_branch... */