Skip to content

Conversation

Copy link

Copilot AI commented Jul 10, 2025

This PR adds comprehensive documentation to address the common issue where users encounter "Failed to create trustee or trust for Cluster" errors when using application credentials that weren't created with the --unrestricted flag.

Changes Made

New Authentication Documentation (docs/admin/authentication.md)

  • Explains why the --unrestricted flag is required for Magnum application credentials
  • Provides clear examples of correct credential creation commands
  • Details the technical reasons (trust relationships and trustee creation requirements)
  • Includes security considerations and best practices
  • Cross-references troubleshooting documentation

Enhanced Troubleshooting Documentation (docs/admin/troubleshooting.md)

  • Added dedicated section for "Failed to create trustee or trust for Cluster" error
  • Updated existing application credential commands to include --unrestricted flag
  • Added warning callouts about authentication requirements
  • Linked to the new authentication documentation for comprehensive guidance

Updated Navigation (docs/SUMMARY.md)

  • Added the new authentication documentation to the administrator guide navigation

Problem Solved

Users who create application credentials without the --unrestricted flag encounter cryptic errors like:

Failed to create trustee or trust for Cluster

This happens because non-unrestricted application credentials lack the permissions needed to create the trust relationships that Magnum requires for cluster management operations.

Solution Provided

The documentation now clearly explains:

  • Why: The technical requirement for unrestricted credentials
  • How: Correct command syntax with examples
  • When: Best practices for credential management
  • Troubleshooting: What to do if you encounter the error

Example of the correct approach now documented:

openstack application credential create --unrestricted magnum-cluster-api

This documentation will help users avoid this common pitfall and provide a clear path to resolution when they encounter the issue.

Fixes #749.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copilot AI changed the title [WIP] "Failed to create trustee or trust for Cluster" when using app creds which aren't unrestricted Document unrestricted application credential requirement for Magnum clusters Jul 10, 2025
Copilot AI requested a review from mnaser July 10, 2025 00:48
Copy link
Member

@okozachenko1203 okozachenko1203 left a comment

Choose a reason for hiding this comment

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

The problem is caused because the user who creates magnum cluster uses application credential without unrestricted enabled. it is not related to the application credential which magnum-cluster-api creates and uses to interact with openstack

@okozachenko1203
Copy link
Member

@mnaser i think copilot only accepts the review from you :)

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.

"Failed to create trustee or trust for Cluster" when using app creds which aren't unrestricted

3 participants