Project Management
This guide describes project management for Standard Version where administrators manage all project aspects.
For Pro Version project management, please refer to the Pro Version Guide which includes additional roles like Space Owner, Project Owner, etc.
Creating Projects
You can create projects in three ways:
Method 1: Manual Creation
- Navigate to
Projects/Projects
in the main menu - Click on "New" button
- Fill in the project details:
- Project Name
- Environment (dev/staging/prod)
- Space (default in standard version)
- Other project configurations
- Configure deployment settings:
- Git repository
- Deployment path
- Build commands
- Pre-deployment Commands (Optional)
- Post-deployment Commands (Optional)
For detailed project configuration options, please refer to Project Configuration Guide which covers:
- Project Information
- Repository Settings
- Deployment Configuration
- Deployment Commands
Method 2: Import YAML
- Navigate to
Projects/Projects
in the main menu - Click "Import YAML" button
- Select your YAML file
- Review and confirm the configuration
Method 3: Copy Existing Project
- Navigate to
Projects/Projects
in the main menu - Find the project you want to copy
- Click the action menu (three dots)
- Select "Copy"
- The system will create a new project with the same configurations but a new name
Managing Projects
Viewing Projects
- Navigate to
Projects/Projects
- Use the search bar to find specific projects
- Click "View" to see project details
Editing Projects
- Select the project from the list
- Click "Edit" next to the project name
- Modify project settings as needed:
- Basic information
- Deployment configurations
- Build commands
- Save your changes
Exporting Project Configuration
- Navigate to
Projects/Projects
- Find the project you want to export
- Click the action menu (three dots)
- Select "Export YAML"
- The YAML file will be automatically downloaded
Deleting Projects
- Select the project from the list
- Click the action menu (three dots)
- Select "Delete"
- Confirm the deletion
⚠️
Projects that are referenced by tickets cannot be deleted. You must first remove all ticket dependencies before deletion.
Best Practices
- Use clear and consistent project naming conventions
- Regularly review and update project configurations
- Document any changes to project settings
- Back up important project configurations using YAML export
- Test configuration changes in development environment first
For Pro Version features and role-based project management, please refer to the Pro Version Guide.