[BUG]ProductLink ID conflict during Publish after upgrading from v4 to v7
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
Research direction
Start by reproducing the migration with the v7 Extractor and Publisher using the two-environment ProductLink setup described in the issue. Inspect the generated configuration for the captured productLink ID and compare the Publisher's handling of that link with the existing target link; done means deployment succeeds when the environments use different internal IDs.
Written by the indexing model from the issue text.
Description
Release version
APIM v7.0.0
Describe the bug
We are currently migrating our APIM DevOps process from v4 (specifically version [Insert Exact Version]) to v7.
In our existing environment (deployed originally using v4), we have several Groups linked to Products. In the v4 repository structure, these links were handled without explicit IDs in the configuration files.
When using the v7 Extractor on our Development environment, the tool now captures the productLink ID and stores it in the repository.
When we run the v7 Publisher to deploy these changes to higher environments (Test/Prod), the deployment fails.
The error indicates that a productLink already exists on the target environment but has a different Resource ID than the one captured from Dev and stored in the repo.
In v4: The extracted files did not contain a specific productLink ID. Deployment worked seamlessly across environments as it likely matched by name/relation rather than a specific GUID.
In v7: The productLink ID is hardcoded in the extracted JSON/YAML. If the target environment already has that link established with a different ID, the Publisher fails.
Is this change in behavior (hardcoding the productLink ID during extraction) an intended feature or a bug?
Is there a recommended workflow to resolve this conflict during a migration? Should these IDs be tokenized, or is there a way to make the Publisher ignore the ID and match by Product/Group name instead?
Expected behavior
The Publisher should be able to synchronize Product-to-Group links across different environments regardless of the internal Resource ID (GUID).
Since these links represent a relationship between two named entities (a specific Product and a specific Group), the tool should ideally match them by name/reference or update the existing link.
Upgrading from v4 to v7 should not break existing CI/CD pipelines for resources that were previously deployed without explicit IDs.
Actual behavior
The v7 Extractor captures a specific, hardcoded ID for the productLink resource, when the Publisher attempts to deploy this to a target environment where the link already exists (but was created with a different internal ID), the deployment fails with a conflict error.
Reproduction Steps
- Environment Setup: Have two APIM instances (Dev and Prod). Link a Group to a Product in both environments
- Extraction: Use the v7 Extractor on the Dev environment.
*the generated configuration file now contains a specific GUID/ID for the productLink. - Deployment: Run the v7 Publisher using the extracted files from step 2, targeting the Prod environment.
- Failure: The Publisher fails during the productLink deployment phase because the link already exists in Prod with a different ID than the one captured from Dev.
- Dominant language
- C#
- Stars
- 448
- Forks
- 247
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Azure/apiops
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 3/5 1-2 days Newbie friendliness 70/100
-
Difficulty 4/5 3-5 days Newbie friendliness 55/100
-
Difficulty 3/5 1-2 days Newbie friendliness 45/100
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
nightscout/nocturne#1425 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
RayWangQvQ/BiliBiliToolPro#1137 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100