99 أسطر
1.8 KiB
Markdown
99 أسطر
1.8 KiB
Markdown
# Projects
|
|
|
|
Projects are the foundation of resource organization in Ghaymah CLI. They provide a structured way to group and manage your resources, making it easier to maintain complex deployments and collaborate with team members.
|
|
|
|
|
|
|
|
## Commands Reference
|
|
|
|
### Creating a Project
|
|
|
|
Create a new project with a specified name:
|
|
|
|
```bash
|
|
gy resource project create --set .name="my-awesome-project"
|
|
```
|
|
|
|
**Short form:**
|
|
```bash
|
|
gy r p c --set .name="my-awesome-project"
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
# Create a project for a web application
|
|
gy resource project create --set .name="web-app-frontend"
|
|
```
|
|
|
|
### Listing Projects
|
|
|
|
View all existing projects:
|
|
|
|
```bash
|
|
gy resource project get
|
|
```
|
|
|
|
**Short form:**
|
|
```bash
|
|
gy r p g
|
|
```
|
|
|
|
|
|
### Updating a Project
|
|
|
|
Modify an existing project's properties:
|
|
|
|
```bash
|
|
gy resource project update <PROJECT_ID> --set .name="updated-name"
|
|
```
|
|
|
|
**Short form:**
|
|
```bash
|
|
gy r p u <PROJECT_ID> --set .name="updated-name"
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
# Update project name
|
|
gy resource project update proj_123abc --set .name="web-app-backend"
|
|
```
|
|
|
|
### Deleting a Project
|
|
|
|
Remove a project and all its associated resources:
|
|
|
|
```bash
|
|
gy resource project delete <PROJECT_ID>
|
|
```
|
|
|
|
**Short form:**
|
|
```bash
|
|
gy r p d <PROJECT_ID>
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
# Delete project by ID
|
|
gy resource project delete proj_123abc
|
|
```
|
|
|
|
> ⚠️ **Warning**: Deleting a project will permanently remove all associated resources. This action cannot be undone.
|
|
|
|
## Best Practices
|
|
|
|
### Naming Conventions
|
|
- Use descriptive names: `web-app-frontend`, `api-service-v2`
|
|
- Include environment indicators: `my-app-staging`, `my-app-production`
|
|
- Keep names concise but meaningful
|
|
|
|
|
|
|
|
## Related Commands
|
|
|
|
- `gy resource --help` - View all resource management commands
|
|
- `gy resource project --help` - View all project management commands
|
|
|
|
---
|
|
|
|
|