Cloud Manager branch selection field read-only due to repository access token permissions

This article explains why the branch selection field in the Fullstack Development Pipeline of Cloud Manager may become read-only and how to resolve the issue by updating repository access token permissions.

Description description

Environment

Adobe Experience Manager (AEM) Cloud Manager (all versions)

Issue/Symptoms

  • When editing a Fullstack Development Pipeline in Cloud Manager and navigating to the Source code tab, the Branch selection field is read-only and displays an error message.
  • You are unable to select or change the branch for the pipeline.
  • The repository is connected to an external GitLab instance.
  • The issue persists even after updating an expired access token if the token doesn’t have the required API permissions.

Cause

This issue occurs when the access token used for the external repository connection in Cloud Manager lacks the necessary API permissions, preventing Cloud Manager from retrieving the list of branches.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Verify that the access token used for the repository connection in Cloud Manager is active and not expired or revoked in GitLab.
  2. Ensure that the token has the required api or, at minimum, read_api scope/permissions in GitLab. Tokens with only read_repository may allow deployments but prevent branch listing and selection in Cloud Manager.
  3. In Cloud Manager, go to Repositories > Manage Access Tokens.
  4. Open the token for the relevant repository, paste the current/latest access token value, and click Update.
  5. On the repository row, click the … menu > View & Update, and click Update again.
  6. Wait for Cloud Manager to automatically revalidate the repository connection.
  7. Edit the pipeline again and navigate to the Source code tab. The branch field should now be editable, and the available branches should be listed.
recommendation-more-help
experience-cloud-kcs-help-kbarticles