ado-asana-sync

ado-asana-sync

This project aims to synchronize work items between Azure DevOps (ADO) and Asana. It's currently in development and not ready for use. Breaking changes will occur as needed.

How to use

• Get the latest container image from the Github Container Registry.
• Configure the environment variables with the relevant values:
  • ADO_PAT - Your Personal Access Token for ADO to accesst the work items.
  • ADO_URL - The full URL of your Azure DevOps instance.
  • ASANA_TOKEN - Your Personal Access Token for Asana to access the work items.
  • ASANA_WORKSPACE_NAME - Name of the Asana workspace to sync with.
  • CLOSED_STATES - Comma separated list of states that will be considered closed.
  • THREAD_COUNT - Number of projects to sync in parallel. Must be a positive integer.
  • SLEEP_TIME - Duration in seconds to sleep between sync runs. Must be a positive integer.
  • SYNCED_TAG_NAME - Name of the tag in Asana to append to all synced items. Must be a valid Asana tag name.
• Run the container with the configured environment variables.
• The application will start syncing work items between ADO and Asana based on the configured settings.

Development

Commit message style

This repo uses Conventional Commits to ensure the build numbering is generated correctly

Manual testing

To test the application manually, you can use the following steps:

1. Create new ADO work item and ensure it is synced to Asana.
2. Rename Asana task and ensure it is reverted back to the ADO name.
3. Rename ADO task and ensure it is synced to Asana.
4. Remove Synced tag from item in Asana and ensure it is replaced.
5. Delete synced tag from Asana workspace and from appdata.json file and ensure it is re-created and assigned to all synced tasks.
6. Mark Asana task as complete and ensure it is re-opened.
7. Mark ADO task as complete and ensure it is marked as complete in Asana.
8. Re-open ADO task and ensure it is re-opened in Asana.

Reference

ADO

• azure-devops PyPi
• azure-devops GitHub
• azure-devops API reference
• azure-devops samples

Asana

• Asana PyPi
• Asana GitHub
• Asana API Reference