laurigates/argocd-login

ArgoCD CLI Login

ArgoCD CLI authentication with SSO for the Data Portal cluster.

When to Use This Skill

| Use this skill when... | Use kubernetes-operations instead when... | |---|---| | Authenticating to ArgoCD CLI via SSO | Working directly with kubectl against the cluster | | Resolving ArgoCD CLI auth errors before running argocd commands | Inspecting Kubernetes workloads without going through ArgoCD | | Setting up gRPC-Web access to argocd.dataportal.fi | Using kubectl-debugging to debug a specific pod or node |

When to Use

Use this skill automatically when:

• User requests ArgoCD login or authentication
• User mentions accessing ArgoCD cluster or applications
• User needs to interact with ArgoCD CLI tools
• Authentication errors occur when using ArgoCD commands

Authentication Command

argocd login argocd.dataportal.fi --grpc-web --sso

Command Breakdown

• argocd.dataportal.fi - Data Portal ArgoCD server endpoint
• --grpc-web - Enable gRPC-Web protocol (required for web-based SSO)
• --sso - Use Single Sign-On authentication (opens browser for OAuth2 flow)

Usage Flow

1. Detect authentication need:

   • User explicitly requests login
   • ArgoCD command fails with authentication error
   • User mentions accessing ArgoCD cluster

2. Execute login command:

   argocd login argocd.dataportal.fi --grpc-web --sso
   

3. Guide user through SSO:

   • Command will open browser automatically
   • User completes SSO authentication in browser
   • CLI receives token upon successful authentication
   • Session is stored in ~/.config/argocd/config

4. Verify authentication:

   argocd account get-user-info
   

Common ArgoCD Operations (Post-Login)

Application Management

# List applications
argocd app list

# Get application details
argocd app get <app-name>

# Sync application
argocd app sync <app-name>

# View application resources
argocd app resources <app-name>

Cluster Information

# List clusters
argocd cluster list

# Get cluster info
argocd cluster get <cluster-name>

Project Management

# List projects
argocd proj list

# Get project details
argocd proj get <project-name>

Authentication Session

• Session storage: ~/.config/argocd/config
• Session persistence: Tokens have configurable expiration
• Re-authentication: Run login command again when session expires

Troubleshooting

Browser doesn't open

• Manually open the URL printed by the CLI
• Complete authentication in browser
• Token will be received by CLI

gRPC-Web errors

• Ensure --grpc-web flag is present
• Check network connectivity to argocd.dataportal.fi
• Verify firewall/proxy settings allow gRPC-Web traffic

SSO failures

• Verify SSO provider is accessible
• Check browser for authentication prompts
• Ensure popup blockers aren't interfering
• Try incognito/private browsing mode

Token expiration

• Re-run login command: argocd login argocd.dataportal.fi --grpc-web --sso
• Check token validity: argocd account get-user-info

Integration with ArgoCD MCP

This skill complements the ArgoCD MCP server tools:

• MCP tools (mcp__argocd-mcp__*) require authenticated CLI session
• Use this skill to establish authentication before MCP operations
• Both use same configuration (~/.config/argocd/config)

Security Considerations

• Token storage: CLI tokens stored locally in config file
• Token scope: Full ArgoCD access (read/write based on RBAC)
• Token rotation: Re-authenticate periodically for security
• Shared sessions: CLI and MCP share authentication state

Example Interaction

User: "I need to check the status of my ArgoCD applications"

Claude: I'll log you into ArgoCD first, then check the application status.

[Executes: argocd login argocd.dataportal.fi --grpc-web --sso]

Please complete the SSO authentication in the browser that just opened.
Once authenticated, I'll retrieve your application list.

[After successful auth, executes: argocd app list]

Here are your applications:
...

Related Skills

• Kubernetes Operations - For kubectl operations on ArgoCD-managed resources
• GitHub Actions Inspection - For CI/CD pipeline integration with ArgoCD
• Infrastructure Terraform - For infrastructure managed by ArgoCD applications

References

• ArgoCD CLI Documentation
• ArgoCD SSO Configuration
• gRPC-Web Protocol