Skip to content

Conversation

yaningo
Copy link
Contributor

@yaningo yaningo commented Sep 19, 2025

Description

  • Replaced current instructions for the manual setup with steps using the guided setup.
  • Updated screenshots accordingly.

Reasons

A new guided setup is now available to replace the previous manual setup process.

Content Checklist

Please follow our style when contributing to CircleCI docs. Our style guide is here: https://circleci.com/docs/style/style-guide-overview.

Please take a moment to check through the following items when submitting your PR (this is just a guide so will not be relevant for all PRs):

  • Break up walls of text by adding paragraph breaks.
  • Consider if the content could benefit from more structure, such as lists or tables, to make it easier to consume.
  • Keep the title between 20 and 70 characters.
  • Consider whether the content would benefit from more subsections (h2-h6 headings) to make it easier to consume.
  • Check all headings h1-h6 are in sentence case (only first letter is capitalized).
  • Include relevant backlinks to other CircleCI docs/pages.

@yaningo yaningo requested review from a team as code owners September 19, 2025 13:33
@yaningo yaningo changed the title Documenting new guide setupt for rollback pipeline Documenting new guide setup for rollback pipeline Sep 19, 2025
. Review the generated YAML configuration template to ensure you understand the rollback pipeline.
. Select btn:[Commit Config] to create this rollback configuration template in your repository. The configuration will be committed to a new branch called `rollback-pipeline-setup` in your selected repository.
. Expand the **Add deploy markers to existing pipeline** section.
. In the **Environment Name** dropdown, select or type the xref:configure-deploy-markers#manage-environments[target environment].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add something here about what environments are - can you the same language as the tooltip in the app actually. Also mention if you don't have any set up yet adding one here will set up an environment of that name for you when a pipeline runs .... I think that's correct anyway

(Same feedback for numxt bullet point too)


This config is a template rollback pipeline that includes the following:
. The setup will auto-generate deploy marker commands based on your selections.
. Copy the generated commands using the btn:[Copy] button and paste them into your existing config file where the deployment occurs.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think make it clear they are going to need to break this snipp up so the plan happens before their actual deployment and the update after? @rafaelmtorres just wondering if it would make sense to have two snippets not one for this reason?


=== 6. Access rollback functionality
Once the pull request is merged, the rollback setup is complete. You can now use the rollback functionality in the CircleCI UI.
You can now use the rollback functionality in the CircleCI UI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can now rolback deployments by running a rollback pipeline

or something like that

because they can already use a workflow rollback without all this work

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants