TugboatQA / docs

Tugboat Docs
https://docs.tugboat.qa
MIT License
9 stars 18 forks source link

Document how to integrate Tugboat with GitHub-for-JIRA #394

Open q0rban opened 4 weeks ago

q0rban commented 4 weeks ago

When:

JIRA will show deployments as unmapped. We should document how to set this up so that Tugboat environments display properly in JIRA.

image

@owenbush discovered the following:

Looks like I managed to get Github, and JIRA configured to no longer have unnamed environment releases. In Github we now have 4 environments set up: Dev Test Tugboat Pantheon I then added a .jira/config.yml file to our repo with the following environment mappings:

deployments:
  environmentMapping:
    development:
      - "Dev"
    testing:
      - "Tugboat"
    staging:
      - "Test"
    production:
      - "Pantheon"

Deployments to Dev should show up as Development in JIRA Deployments to Tugboat should show up as Testing in JIRA Deployments to Test should show up as Staging in JIRA Deployments to Pantheon should show up as Production in JIRA Below is a screenshot of a release for an issue that was just deployed to Tugboat. Screenshot 2024-08-14 at 1 31 22 PM

To me it felt like Tugboat is more of a testing environment than a staging environment which is why I did the mapping that way. But this could be up to whoever the devs are on a project.

KeyboardCowboy commented 4 weeks ago

@qorban, where is the right place for something like this? Should we start a new section for third party integrations?

https://docs.tugboatqa.com/

KeyboardCowboy commented 3 weeks ago

Let's create a new top-level item for 3rd party integrations and move other things out of snippets as well.