Skip to content

Conversation

@default2368
Copy link

  • I have registered the PR changes.

Ⅰ. Describe what this PR did

Added comprehensive documentation for OpenServerless covering:

  • Complete installation and setup guide (prerequisites, system requirements, installation steps)
  • Development environment configuration (WSL2, Docker, Kubernetes)
  • Nuvolaris CLI usage and commands
  • Deployment workflows and best practices
  • Troubleshooting common issues
  • Architecture overview and key concepts

Ⅱ. Does this pull request fix one issue?

No, this PR improves documentation by adding comprehensive guides for developers.

Ⅲ. Why don't you add test cases (unit test/integration test)?

No tests needed as this is a documentation-only contribution. The documentation has been verified for technical accuracy and completeness.

Ⅳ. Describe how to verify it

  1. Review the documentation files for technical accuracy
  2. Check that all code examples are correct and follow best practices
  3. Verify that links and references are working
  4. Test any command examples provided in the guides

Ⅴ. Special notes for reviews

  • All technical commands and configurations have been tested
  • Follows the existing documentation structure and style
  • Ready for review by maintainers

@default2368 default2368 changed the title add OVERVIVIEW.md - quick cli guide, system architeture - add OVERVIEW.md - quick cli guide, system architeture - Oct 26, 2025
└─────────────────────────────────────────┘
```

### Dependency Flow
Copy link
Contributor

Choose a reason for hiding this comment

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

what is this section?

Copy link
Author

Choose a reason for hiding this comment

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

if you red, i read to; consider claude writes this guide, basing on my questions; so it needs to be reviewed the whole documentations; i comment here to accept your exceptions. thanks

- Manages native K8s resources (pods, services, secrets, namespaces)
- Operates at **low infrastructure level**

**Essential Commands:**
Copy link
Contributor

Choose a reason for hiding this comment

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

do not expose kubectl also because it is actually hidden inside ops - we have a full set of ops debug utils

ops result <activation-id>
```

### Relationship between kubectl and ops
Copy link
Contributor

Choose a reason for hiding this comment

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

do not expose kubecti in this overwview - you do not have generally access to it - it is an implementation detail


**System:**
- Docker Desktop with at least 6GB RAM
- 20GB+ available disk space
Copy link
Contributor

Choose a reason for hiding this comment

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

34gb

ops setup status

# 5. Check active pods
kubectl get pods --all-namespaces
Copy link
Contributor

Choose a reason for hiding this comment

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

ops debug watch it is better


```bash
# Create and configure a local dev cluster
ops setup devcluster
Copy link
Contributor

Choose a reason for hiding this comment

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

ops setup mini please (forget devcluster)

ops setup devcluster
```

### Verify Installation
Copy link
Contributor

Choose a reason for hiding this comment

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

no, use the ops util, ops debug, ops debug kube commands

ops admin adduser <username> <email> <password>

# With all services
ops admin adduser mario mario@example.com Pass123! --all --storagequota=auto
Copy link
Contributor

Choose a reason for hiding this comment

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

warn here the ! will create errors in most shells unquoted

# Specific user details
ops admin listuser mario

# With kubectl
Copy link
Contributor

Choose a reason for hiding this comment

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

no


### Changing User Password

**Problem**: `ops` has no direct command to change password.
Copy link
Contributor

Choose a reason for hiding this comment

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

actually there is... in an api - we have to add here

@sciabarracom
Copy link
Contributor

I have to close this PR as it looks AI generated and pretty inaccurate.

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.

2 participants