Best Practices
Application Design
Do:
- Use descriptive, unique component labels
- Group related components visually on canvas
- Document applications with descriptions
- Use meaningful environment variable names
Don’t:
- Use generic names like “app” or “service”
- Hardcode secrets in environment variables
- Skip validation before publishing
Version Management
Do:
- Use semantic versioning (
v1.0.0,v1.1.0,v2.0.0) - Write meaningful version descriptions
- Test thoroughly in draft before publishing
Don’t:
- Skip version numbers randomly
- Publish untested configurations
- Delete all versions without backup
Security
Do:
- Use environment variables for configuration
- Set appropriate restart policies
- Use specific image tags (not
latest)
Don’t:
- Store passwords in plain environment variables (use secrets)
- Run containers as root unnecessarily
- Grant excessive permissions
Team Collaboration
Do:
- Write clear descriptions and version notes
Don’t:
- Skip descriptions when publishing
- Ignore notifications about applications you use