Projects
Projects are the central point of Skysize, they contain all the deployments linked to your odoo repository
New Project
To create a project go to the project creation page.
- The VCS Provider Github, Gitlab, Bitbucket
- The chosen repository from your vcs The name of the repository will also be the name of the project. This can be changed once the project is created
- The billing account You need either a complete billing account or a trial account
- The odoo version The supported odoo version. This can be changed later
- The region Where your instance will be deployed
Once created, you will be redirected to the project page
Branches
Branches Types
There are 3 types of branches on Skysize:
- Production: This is your production database. It is backed up daily and is the main odoo instance that your users will interact with. You can only have one of them.
- Staging: This are your databases that are used for testing. They contain a snapshot of your production database and are used to test new features before deploying them to production. You can have multiple of them but only one per branch and they are not backed up!
- Development: This are your databases that are used for development. They contain demo data and tests are automatically run on them. You can have multiple of them but only one per branch and they are not backed up! Development branches are automatically garbage collected after 24 hours.
Changing a branches types
To change the type of a branch, go to your project page under the branches tab. Select the desired type using the radio buttons. This will automatically create a new build of the type chosen.
Branch settings
Branches have 2 settings that can be defined
- Branch Version: The Odoo version that will be run on this branch. This can be changed at any time.
- On push Action: The action that will be taken when a commit is pushed to this branch. This can be either "New", to create a new database, or "Update" to update the existing database or "None" to do nothing.
Domains
Default Domain Structure
When you create and deploy your projects on our platform, they will be assigned default domain names based on the following structure:
- Production:
project-name.skysize.io
- Staging:
project_name-branch_name.staging.skysize.io
- Development:
build_name.dev.skysize.io
Examples
- Production: For a project named "awesomeapp" the production domain would be
awesomeapp.skysize.io
- Staging: If you are working on a feature branch named "new-feature" for "awesomeapp" the staging domain would be
awesomeapp-new-feature.staging.skysize.io
- Development: A specific build in development for "awesomeapp" might have a domain like
build123.dev.skysize.io
Security and Protection
All domain names under skysize.io
are provided by Cloudflare, ensuring that your projects benefit from Cloudflare's robust security and performance features.
Bring Your Own Domain
Our platform allows you to use your own custom domain names for your projects. This can be easily configured through the project settings.
- 1. Add Custom Domain: Navigate to the project settings.
- 2. Enter Domain Name: Add your custom domain name..
- 3. We'll Handle the Rest: Our system will take care of the configuration, ensuring seamless integration and continued protection by Cloudflare.
By using a custom domain, you can maintain your brand identity while still benefiting from the security and performance features provided by Cloudflare.
Odoo Workers
An Odoo worker is a process responsible for handling various tasks within the Odoo framework. These tasks include processing user requests, executing background jobs, and managing data transactions. Each worker operates independently, allowing Odoo to handle multiple tasks simultaneously and improve overall performance and scalability.
Managing Odoo Workers
In a production environment, it is crucial to optimize the number of Odoo workers to ensure efficient handling of your application’s load. Our platform allows you to adjust the number of workers for your production instance.
Configuring Workers in Production
- Adjust Worker Count: You can change the number of Odoo workers in the project settings under the project settings section.
- Scalability: Increasing the number of workers can help manage higher traffic and improve response times, while decreasing the number might be beneficial for cost savings during low-traffic periods.
Staging and Development Environments
For staging and development environments, the number of Odoo workers is pre-configured and cannot be changed. This ensures a consistent testing and development experience, closely matching the default production environment settings.
Access Rights
User Roles and Permissions
In our platform, you can manage who has access to your project and what actions they can perform by assigning specific roles. There are two roles available: User and Admin.
Managing Users
You can add and manage users in the project settings. Here’s a detailed look at the permissions associated with each role:
User
- View Access: Users can view the project details and monitor its status.
- Restricted Operations: Users are not allowed to perform deployment operations. This includes actions such as retrying deployments, importing backups, restoring backups, and managing other users.
Admin
- Full Access: Admins have complete control over the project.
- Deployment Operations: Admins can perform all deployment-related tasks, including retrying deployments, importing backups, restoring backups, and managing user permissions.
- User Management: Admins can add, remove, and modify user roles within the project settings.
Billing
This section explains everything related to the billing
Billing Accounts
Billing accounts are the cornerstone of your billing experience. They contain your billing information and payment as well as your invoices, payment history and committed discounts. You can have as many billing account as you desire. You can for example have one billing account per project or per client.
In order to have an active billing account, you need to complete your billing information. This includes your company name, address, VAT number and payment method and add a payment method.
Committed discounts
If you have a predictable and consistent need for resources, you can benefit from purchasing a committed discount. This will allow you to have a discount on your monthly bill. This option provides a discount on your monthly bill based on the amount of resources you commit to using over a specified period. The longer the commitment, the greater the discount you receive.
Committed discounts are paid upfront are non refundable. They are automatically applied to your monthly bill. If you do not use the resources you committed to, you will not be refunded.
Committed discounts are renewed automatically at the end of the period. If you do not want to renew them, you can cancel them at any time. If you cancel early, you still benefit from the discount until the end of the period.
You can increase the amount of discounted resources from a committed discount at any time. You will be charge a prorated amount for the additional resources.
You can purchase committed discounts in the "committed discounts" of your billing account.
Invoices
Each time a payment is made, an invoice is generated. You can access all your invoices in the "invoices" section of your billing account. You can also download them in PDF format.Billing information
To activate and maintain a valid billing account, you must enter your billing information, including your company name, address, and VAT number. Additionally, you need to add a credit card as the primary payment method.
Access rights
Our platform provides three distinct access rights for managing billing accounts: View Name, View Billing, and Admin. These roles offer varying levels of access and control, ensuring that each user has the appropriate permissions based on their responsibilities.
View Name
- Access Level: Users with this role can only see the name of the billing account.
- Restrictions: No additional billing information is accessible to users with this role.
View Billing
- Access Level: Users with this role have read-only access to all billing account information.
- Permissions: This includes viewing billing details, payment history, invoices, and committed discounts.
- Restrictions: Users cannot make any changes or perform any administrative tasks.
Admin
- Access Level: Users with this role have full access to all billing account information and functionalities.
- Permissions: Admins can perform any action, including adding or modifying billing details, making payments, managing discounts, and viewing all account information.
- User Management: Admins can also add new users and change the roles of existing users within the billing account.
Usage billing
Monthly Invoices and Payments
On the first of each month, an invoice is generated that includes your usage for the previous month, minus any committed discounts you have purchased.
Billing by Minute
All resources are billed in minute increments to ensure precise billing based on your actual usage.
Example Scenario
Committed Discount Usage
- If you have a committed discount for 2 workers but increase the number of workers to 4 for two weeks, you will be billed for the additional usage.
- Calculation: (4 - 2) workers * 14 days * 24 hours/day * 60 minutes/hour * price per worker.
Payments
Default Payment Method
Credit cards are set as the default payment method for all users.
Bank Transfer Option
Bank transfer can be activated manually on an account, based on specific criteria. If you wish to use bank transfer as your payment method, please contact our support team for assistance.
Bank Transfer Option
- Credit Card Payments: Invoices generated for pay-as-you-go usage have standard payment terms.
- Bank Transfer Payments: Invoices generated for pay-as-you-go usage when using bank transfer as the payment method will have a 7-day payment term.
Committed Usage Activation
- Credit Card Payments: Committed usage is active immediately upon payment.
- Bank Transfer Payments: Committed usage will only become active once we receive the payment, not upon the payment's completion.
Payment Process
For on-the-go usage, charges will be made to your primary card. If the primary card payment fails, we will attempt to charge your backup card. For committed discounts, you will be prompted to choose the payment method.
Grace Period and Deactivation
- Payment Failure: If both payment attempts fail, you will have a 7-day grace period to resolve the issue.
- Deactivation: After the 7-day grace period, any projects linked to the billing account will be deactivated.
- Deletion: Deactivated projects will be permanently deleted after 30 days.
Reactivating Projects
To reactivate a project, simply process the payment. Once the payment is successfully completed, your project will be reactivated.
Trial
Trial Account Creation
Every new user is eligible to claim a free trial. Upon claiming the trial, a trial billing account will be created. This trial account allows you to create one project.
Trial Duration and Project Limitations
- Trial Period: The trial account is valid for 7 days from the date of creation.
- Project Limitation: The project created during the trial will be limited to one worker.
During the trial period, you can explore our platform and experience its capabilities firsthand. If you have any questions or need assistance during your trial, our support team is here to help.
Hosting
Skysize offers top notch hosting. Discover everything that we offer below
Deployments
Deployments host an Odoo server with your latest code changes. Whenever a commit is pushed to your branches, a deployment process is initiated.
Deployment Actions
- Create New: A new deployment is created, each with its own set of data. The older deployment (if existing) is garbage collected.
- Update: The deployment updates the latest deployment with the new changes.
- No Action: In some cases, the deployment may not require any changes and will remain unchanged.
Deployment Management
- Production and Staging: Production and staging branches always have one active deployment (if possible) to ensure continuous availability and testing.
- Development: Deployments associated with development branches are automatically garbage collected after 24 hours to maintain a clean and efficient development environment.
Backups
Daily Backup Creation
Backups are generated daily at 1 am and stored in three different locations for redundancy and robustness. Two backups are stored in Google Cloud Platform (GCP) locations within the same region, and one backup is stored in a different region and cloud provider (AWS).
Backup Policy
The backup policy includes 7 daily backups, 4 weekly backups, and 2 monthly backups, ensuring comprehensive data protection and retention.
Manual Backup Creation
Users can initiate manual backups, which will be retained for 7 days.
Restore and Download
- Restore: Backups can be restored at any time on any branch, ensuring flexibility and ease of recovery.
- Download: Users have the option to download backups for offline storage or archival purposes.
- Import: Backups can be imported, and upon import, they can be deployed on the selected branch.
Sanctioned Countries
To comply with regulations, we block access to Skysize and any databases hosted under our domain from sanctioned countries listed below.
Version Control Integration
You can connect your skysize account to your Github, Gitlab or Bitbucket account to allow the use of those repositories. You can enable the integration on your profile.