Add A Pipeline ============== Pipelines are containers that organize and execute workflows. The pipeline workflows are comprised of small actions called steps which are ordered and executed either manually or by a set of configurable conditions. Each project type is bundled with a standard set of pipelines to perform basic deployment workflows between the environments configured for a project. You can see a listing of the project pipelines in the Pipelines dashboard by clicking the Pipelines icon in the left-side toolbox. It looks like a command prompt with a little cursor: >_ .. note: screenshot starting width: 1200 x 675 or 1200 x 900 .. |Pipelines Icon| image:: ../../../shared/images/v2.6.2/portal/icon_pipelines.jpg :height: 16 :align: middle :alt: Open the Pipelines dashboard .. |Plus Icon| image:: ../../../shared/images/v2.6.2/portal/icon_plus.jpg :height: 16 :align: middle :alt: Click to add a pipeline .. |Project Pipelines| image:: ../../../shared/images/v2.6.2/portal/project_pipelines.jpg :width: 400 :alt: The pipelines dashboard lists the pipelines for this project .. |Project Pipeline Form Steps| image:: ../../../shared/images/v2.6.2/portal/project_pipeline_form_steps.jpg :width: 400 :alt: The title and steps portion of the pipeline form .. |Trigger Group| image:: ../../../shared/images/v2.6.2/portal/project_pipeline_trigger_group.jpg :width: 400 :alt: Trigger groups in a pipeline create conditions to automatically execute the pipeline steps Prerequisites +++++++++++++ You will need to log into Cascade as a Project Administrator to add Pipelines. In order to check your permissions, please navigate to the overview page of the project you wish to modify and click the pipelines icon ( |Pipelines Icon| ), you should see the pipelines display below. If your display does not include a plus-sign ( |Plus Icon| ) next to the pipelines header your account does not have sufficient privileges to proceed. |Project Pipelines| .. _TASK Add a New Pipeline: Add A New Pipeline ++++++++++++++++++ Pipelines are available to every project and you should begin this task by navigating to the Overview dashboard within a project where your account is a Project Administrator. From there, click the pipelines icon within the left-side toolbox ( |Pipelines Icon| ). This will cause the pipeline dashboard to display. You may add new steps by creating them in the Actions dashboard. We recommended you create the steps you need prior to proceeding with pipeline creation. More guidance on steps is available in the :doc:`Add A Pipeline Step guide`. Step 1: Enter a name -------------------- #. Click the + icon to the right of the PIPELINES header, The create new pipeline form will appear. #. Fill in the Pipeline Template Name field with a name that describes the workflow in a few words. Examples: Deploy Code to Development, Promote Code from Staging to Production, Update Drupal in Development. Step 2: Select steps -------------------- #. Select the steps that are part of the workflow by dragging them from Available Steps on the left to Active Steps on the right. #. Put the steps in order by dragging and dropping them in the right pane. The ordering shown represents the order the steps will be executed. The form will look something like the screenshot below: |Project Pipeline Form Steps| Step 3: Select trigger group options ------------------------------------ #. Assuming you are creating an action that should be ran manually, there is no more configuration necessary and you need not fill anything out in the trigger groups section at the bottom. #. Click the save button at the bottom of the form to create the Pipeline. The new pipeline will be shown at the bottom of the list. Considerations for Trigger Groups ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :doc:`Use the Pipelines section under Advanced` for further information about configuring trigger groups.