application-run-component-process#

The application-run-component-process step executes a component process and waits for it to complete. This step is only valid in an application process.

Format#

application-run-component-process step "foo" is
    -- name of the component to deploy; required
    component "my-component"

    -- name of the component process to run for each component; required
    process "deploy-my-component"

    -- select resources to run on by resource tag; optional
    -- before 7.1.1.0, the tag must be specified by internal database ID
    select-resources-by-tag "res-tag-1"

    -- select resources to run on based on inventory changes in other components; optional
    select-resources-by-changed-component-list
        -- select components to monitor for inventory changes; optional, repeatable
        -- before 7.1.1.0, the component must be specified by internal database ID
        component "comp-1"
        component "comp-2"

        -- specify which resources of this process's component are selected; required
        --   all - select all resources where this process's component is mapped
        --   with-changed-component - select only resources where both this process's component
        --                            and a monitored component are mapped and the monitored
        --                            component has changed
        select-resources all
    end

    -- don't start further children after a failure; optional
    -- default is false
    fail-fast false

    -- suppress warnings generated by children; optional
    -- default is false
    ignore-child-warnings false

    -- maximum number of concurrent processes; optional
    -- default is unlimited
    max-concurrent-processes unlimited

    -- javascript precondition script that must evaluate to true for the step to execute; optional
    precondition-script
        """
        true
        """

    -- set a component process property value; optional, repeatable
    property "component-process-property-1" = "cpp1-value"
    property "component-process-property-2" = "cpp1-value"
on success
    finish
end

Field Description
Name A name for the step. Other process steps can refer to this step by this name
Component Process The component process to run.

Example#

start is

    start A

    start B

    start C

    start D

end



application-run-component-process step A is

    component "comp-1"

    process "proc-1"

    select-resources-by-tag "resource-tag-1"

    select-resources-by-changed-component-list

        component "component-1"

        component "component-2"

        component "component-3"

        select-resources all

    end

    fail-fast true

    ignore-child-warnings true

    run-on-first-online-resource-only true

    max-concurrent-processes 101

    precondition-script "script-1"

    property "comp-1-prop-1" = "comp-1-prop-value-1"

    property "comp-1-prop-2" = "comp-1-prop-value-2"

    property "comp-1-prop-3" = "comp-1-prop-value-3"

on success

    finish

end



application-run-component-process step B is

    component "comp-2"

    process "proc-2"

    select-resources-by-changed-component-list

        select-resources with-changed-component

    end

on success

    finish

end



application-run-component-process step C is

    component "comp-3"

    process "proc-3"

    select-resources-by-tag "resource-tag-2"

    fail-fast true

    ignore-child-warnings true

    run-on-first-online-resource-only true

    max-concurrent-processes 102

    precondition-script "script-2"

    property "comp-3-prop-1" = "comp-3-prop-value-1"

    property "comp-3-prop-2" = "comp-3-prop-value-2"

    property "comp-3-prop-3" = "comp-3-prop-value-3"

on success

    finish

end



application-run-component-process step D is

    component "comp-4"

    process "proc-4"

on success

    finish

end

Parent topic: Application process steps