diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index a48440e4..deddf900 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -27,16 +27,37 @@ jobs: restore-keys: | ${{ runner.os }}-yarn- - - name: Node.js 18 + - uses: actions/cache@v4 + id: node-modules-cache + with: + path: node_modules + key: ${{ runner.os }}-node_modules-${{ hashFiles('**/yarn.lock') }} + restore-keys: | + ${{ runner.os }}-node_modules- + + - uses: actions/cache@v4 + id: build-cache + with: + path: apps/docs/build/~ + key: ${{ runner.os }}-docs-build-${{ hashFiles('apps/docs/**/*') }} + restore-keys: | + ${{ runner.os }}-docs-build- + + - uses: actions/cache@v4 + id: turbo-cache + with: + path: .turbo + key: ${{ runner.os }}-turbo-${{ hashFiles('**/yarn.lock') }} + restore-keys: | + ${{ runner.os }}-turbo- + + - name: Node.js 20 uses: actions/setup-node@v3 with: - node-version: '18' + node-version: '20' - name: Install Dependencies run: yarn install --frozen-lockfile - name: Run Build run: yarn build - - # - name: Run Lint - # run: yarn lint diff --git a/apps/docs/content/dotnet/how-to/build-pipeline.mdx b/apps/docs/content/dotnet/how-to/build-pipeline.mdx index 62257080..8e0f3a3c 100644 --- a/apps/docs/content/dotnet/how-to/build-pipeline.mdx +++ b/apps/docs/content/dotnet/how-to/build-pipeline.mdx @@ -509,11 +509,29 @@ For example, to connect to a .NET service with hostname = "app" and port = 5000 Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
+ ### prepareCommands @@ -729,10 +747,25 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/dotnet/how-to/create#set-environment-variables) as your .NET application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | - + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your .NET application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** ```yml @@ -808,9 +841,24 @@ Read more about how the [readiness check works](/dotnet/how-to/deploy-process#re Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/dotnet/how-to/create#set-environment-variables) as your .NET application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your .NET application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/dotnet/how-to/create.mdx b/apps/docs/content/dotnet/how-to/create.mdx index 0f4ae317..f9317793 100644 --- a/apps/docs/content/dotnet/how-to/create.mdx +++ b/apps/docs/content/dotnet/how-to/create.mdx @@ -77,11 +77,32 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
.NET service always starts with the minimal resources. @@ -250,154 +271,125 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains .NET and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - +
- - + + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + diff --git a/apps/docs/content/dotnet/how-to/env-variables.mdx b/apps/docs/content/dotnet/how-to/env-variables.mdx index 28742493..51baa74c 100644 --- a/apps/docs/content/dotnet/how-to/env-variables.mdx +++ b/apps/docs/content/dotnet/how-to/env-variables.mdx @@ -13,11 +13,32 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | --------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/dotnet/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/dotnet/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/dotnet/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | +
ParameterDescriptionParameterDescription
- hostname - + hostname The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - + type Specifies the service type `dotnet` and version. -
- Set type:{' '} - ` - dotnet@<version> - `{' '} - or{' '} - ` - dotnet@latest - ` -
-
- Limitations: + + Set type: `dotnet@` or `dotnet@latest` + + Limitations:
Following .NET major versions are currently supported: 6
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified - attributes will be set to their default values. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. + + All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` + - cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). + - minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). + - minRam/maxRam + Optional. Set the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). + - minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float).
- minContainers - - Optional. Default = 1. Defines the minimum number of containers - for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- maxContainers - - Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- envSecrets - - Optional. Defines one or more secret env variables as a key value - map. See env variable{' '} - - restrictions - - . + envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions.
+ + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
Use the [secret env variables](/dotnet/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/dotnet/how-to/scaling.mdx b/apps/docs/content/dotnet/how-to/scaling.mdx index 92b1e0d7..9d801027 100644 --- a/apps/docs/content/dotnet/how-to/scaling.mdx +++ b/apps/docs/content/dotnet/how-to/scaling.mdx @@ -68,11 +68,32 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
.NET service always starts with the minimal resources. diff --git a/apps/docs/content/elasticsearch/how-to/create.mdx b/apps/docs/content/elasticsearch/how-to/create.mdx index 1850c973..d3932651 100644 --- a/apps/docs/content/elasticsearch/how-to/create.mdx +++ b/apps/docs/content/elasticsearch/how-to/create.mdx @@ -11,9 +11,26 @@ First, set up a project in Zerops GUI. Then go to the project dashboard page and **// TODO screenshot (add a new service page)** -| Parameter | Description | Limitations | -| ------------ | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | A unique service identifier like `elasticsearch`,`es` etc. | - duplicate services with the same name in the same project are forbidden
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) | + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
hostnameA unique service identifier like `elasticsearch`,`es` etc. +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
:::caution The hostname is fixed after the service is created. It can't be changed later. @@ -72,11 +89,32 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.5 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
For most cases, the default parameters will work without issues. If you need to limit the cost of the Elasticsearch service, lower the maximal resources. Zerops will never scale above the selected maximums. @@ -180,102 +218,120 @@ The hostname of the second service will be set to `elasticsearch2`. The [single The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains only Elasticsearch services but you can create a `description.yml` with [different types] of services. - - - - - - - - - - - - - - - - - - - - - -{" "} - - - - - - - - - - - - - - - - - - - - - - - +
ParameterDescription
- hostname - - The unique service identifier.

The hostname of the new database will be set to the `hostname` value.

Limitations:
- duplicate services with the same name in the same project are forbidden
- - maximum 25 characters
- - must contain only lowercase ASCII letters (a-z) or numbers (0-9) -
typeSpecifies the service type `elasticsearch` and version.
Set type: `elasticsearch@7`

Limitations:
Currently Elasticsearch versions 6 and 7 are available.
- mode - - Defines the operation mode of Elasticsearch service.
-
HA
Creates a Elasticsearch cluster with 3 database containers and 1 free nginx balancer. This mode is suited for production.

- Zerops always keeps the 3 database containers on different physical machines. All your data is stored redundantly in 3 identical copies. In case of a failure of a container or the underlying physical machine, Zerops automatically disconnects the failed container from the cluster, creates a new container and syncs all data from the remaining 2 copies. Finally the broken container is automatically deleted. -

- NON_HA
- Zerops will create a Elasticsearch database installed in a single container. Useful for non-essential data or dev environments.

- Your data is stored only in a single container. If the container or the underlying physical machine fails, your data since the last backup are lost. Zerops doesn't provide any automatic repairs of single node Elasticsearch services. -
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified attributes - will be set to their default values. -
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED` values. - Default is `SHARED` -
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). -
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). -
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). -
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
hostname + The unique service identifier. + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
type + Specifies the service type `elasticsearch` and version. +
+ Set type: `elasticsearch@7` + + Limitations: +
+ Currently Elasticsearch versions 6 and 7 are available. +
mode + Defines the operation mode of Elasticsearch service. + + HA +
+ Creates a Elasticsearch cluster with 3 database containers and 1 free nginx balancer. This mode is suited for production. + + Zerops always keeps the 3 database containers on different physical machines. All your data is stored redundantly in 3 identical copies. In case of a failure of a container or the underlying physical machine, Zerops automatically disconnects the failed container from the cluster, creates a new container and syncs all data from the remaining 2 copies. Finally the broken container is automatically deleted. + + NON_HA +
+ Zerops will create a Elasticsearch database installed in a single container. Useful for non-essential data or dev environments. + + Your data is stored only in a single container. If the container or the underlying physical machine fails, your data since the last backup are lost. Zerops doesn't provide any automatic repairs of single node Elasticsearch services. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values. +
- cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED` +
- minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer). +
- minRam/maxRam + Optional. Set the minRam or maxRam in GB (float). +
- minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float). +
:::caution diff --git a/apps/docs/content/features/access.mdx b/apps/docs/content/features/access.mdx index e403090e..50f86e4e 100644 --- a/apps/docs/content/features/access.mdx +++ b/apps/docs/content/features/access.mdx @@ -4,6 +4,18 @@ description: Explore how you can work with subdomains, custom domains and ip acc --- import Image from '/src/components/Image'; +import GroupCards from '../../src/components/GroupCards' + +export const languages = [ + { name: "Node.js", link: "/nodejs/how-to/build-pipeline#ports" }, + { name: "Go", link: "/go/how-to/build-pipeline#ports" }, + { name: "Java", link: "/java/how-to/build-pipeline#ports" }, + { name: "PHP", link: "/php/how-to/build-pipeline#ports" }, + { name: ".NET", link: "/dotnet/how-to/build-pipeline#ports" }, + { name: "Rust", link: "/rust/how-to/build-pipeline#ports" }, + { name: "Python", link: "/python/how-to/build-pipeline#ports" }, +] + Zerops offers 3 different ways how to access your application from the internet: @@ -14,15 +26,9 @@ Zerops offers 3 different ways how to access your application from the internet: ## Public access through zerops.app subdomain By default, your runtime service is not publicly accessible. -To test your application, you can enable public access through zerops.app subdomain. Go to the service detail page in Zerops GUI and select **Public access & internal ports** in the left menu. Then toggle the **Zerops subdomain access** switch. Zerops will assign the unique zerops.app subdomain for your application. If you have defined more internal ports with http support in your zerops.yml, Zerops will create the unique zerops.app subdomain for each port. Learn more about how to define internal ports for your runtime: - -- [Node.js](/nodejs/how-to/build-pipeline#ports) -- [PHP](/php/how-to/build-pipeline#ports) -- [Python](/python/how-to/build-pipeline#ports) -- [Go](/go/how-to/build-pipeline#ports) -- [.NET](/dotnet/how-to/build-pipeline#ports) -- [Rust](/rust/how-to/build-pipeline#ports) -- [Java](/java/how-to/build-pipeline#ports) +To test your application, you can enable public access through zerops.app subdomain. Go to the service detail page in Zerops GUI and select **Public access & internal ports** in the left menu. Then toggle the **Zerops subdomain access** switch. Zerops will assign the unique zerops.app subdomain for your application. If you have defined more internal ports with http support in your zerops.yml, Zerops will create the unique zerops.app subdomain for each port. + +

## Environment variables with the same key diff --git a/apps/docs/content/features/infrastructure.mdx b/apps/docs/content/features/infrastructure.mdx index 3851f8c2..9ff8d123 100644 --- a/apps/docs/content/features/infrastructure.mdx +++ b/apps/docs/content/features/infrastructure.mdx @@ -6,28 +6,38 @@ Zerops structure has three levels - _projects_, _services_ and _containers_. ## Project -Project is the top-level entity, which consists of **services**. TODO max amount of projects +The **project** is the top-level entity, encompassing various **services**. It requires a functioning **core**, which includes: -To function properly, a project needs its **"core"** to be running - which contains a logger service, a statistics service, HTTP routing with SSL certificates, IP routing with built-in firewall etc. It is created when the first user service is deployed and is charged a fixed monthly cost. +- Logger and statistics services +- HTTP routing (with SSL certificates) +- IP routing (with built-in firewall) -All services within a project share a dedicated **private network** and can access environment variables of other services. +The core activates when the first user service is deployed and incurs a fixed monthly fee. -Each project is already created with a unique **IPv6 address**, and a unique **IPv4 address** can be assigned to the project for an extra cost. +### Key Features + +- **Private Network**: All services in a project share a dedicated network and have access to each other's environment variables. +- **IPv6/IPv4**: Each project automatically gets an IPv6 address. An IPv4 address can be added at an extra cost. :::tip -You can create a separate project for any environment (development, stage, production) or even for each developer if you so wish. Alternatively, you can benefit from a single project shared among all developers reducing the overall cost. +Create separate projects for different environments (e.g., development, staging, production) or use one project shared among developers to save costs. ::: ## Services & Containers -A project can contain an unlimited number of services. Depending on the type of service, there are either **fully managed** (scaling, repairing, routing), or **partially managed** services. +### Services -Each service contains **one or more Linux containers**, either of identical type as a HA mode and/or of different types. E.g. a fully managed MariaDB service in HA mode consists of 5 containers - 3 database ones and 2 proxies. +Services are responsible for encapsulating your containers. +A project can host unlimited **services**, which can be: -Each container image is based on one of **predefined Zerops images**. Depending on the technology these images range from **fully managed** (databases) to **fully customizable** (Ubuntu). +- **Fully managed**: Includes automatic scaling, routing, and repairs. +- **Partially managed**: Some management aspects are handled manually. -Each runtime environment or static web server services can be made **publicly accessible** through Zerops subdomains or domains, pointing your DNS records to the IPv6 or IPv4 addresses assigned to the project, or by setting up direct access by opening public ports on the assigned IP addresses. +### Containers -:::tip -Check out the section of the technology you need to get more information. -::: +Each service consists of one or more **containers**. Containers may vary by function or type, such as in **HA (High Availability) mode**, where a fully managed MariaDB service might have 5 containers (3 for databases, 2 for proxies). + +- **Predefined Images**: Containers use Zerops' predefined images, ranging from **fully managed** (e.g., databases) to **customizable** (e.g., Ubuntu). +- **Public Accessibility**: Services can be exposed via Zerops subdomains, custom domains, or public ports on IPv6/IPv4 addresses. + +**Refer to the technology section for detailed setup instructions.** diff --git a/apps/docs/content/features/pipeline.mdx b/apps/docs/content/features/pipeline.mdx index f21aa4a3..a627bc73 100644 --- a/apps/docs/content/features/pipeline.mdx +++ b/apps/docs/content/features/pipeline.mdx @@ -3,8 +3,48 @@ title: Build & deploy pipeline description: Learn how to setup a build & deploy pipeline at Zerops. --- +import GroupCards from '../../src/components/GroupCards'; import Image from '/src/components/Image'; +export const languages = [ + { name: "Node.js", link: "/nodejs/how-to/env-variables#how-to-read-env-variables-from-your-nodejs-app" }, + { name: "PHP", link: "/php/how-to/env-variables#how-to-read-env-variables-from-your-php-app" }, + { name: "Python", link: "/python/how-to/env-variables#how-to-read-env-variables-from-your-python-app" }, + { name: "Go", link: "/go/how-to/env-variables#how-to-read-env-variables-from-your-go-app" }, + { name: ".NET", link: "/dotnet/how-to/env-variables#how-to-read-env-variables-from-your-dotnet-app" }, + { name: "Rust", link: "/rust/how-to/env-variables#how-to-read-env-variables-from-your-rust-app" } +] + +export const builds = [ + { name: "Node.js", link: "/nodejs/how-to/build-process##nodejs-build-hardware-resources" }, + { name: "PHP", link: "/php/how-to/build-process#php-build-hardware-resources" }, + { name: "Python", link: "/python/how-to/build-process#python-build-hardware-resources" }, + { name: "Go", link: "/go/how-to/build-process#go-build-hardware-resources" }, + { name: ".NET", link: "/dotnet/how-to/build-process#dotnet-build-hardware-resources" }, + { name: "Rust", link: "/rust/how-to/build-process#rust-build-hardware-resources" }, + { name: "Java", link: "/java/how-to/build-process#java-build-hardware-resources" }, +] + +export const customiseBuild = [ + { name: "Node.js", link: "/nodejs/how-to/build-process#customise-nodejs-build-environment" }, + { name: "PHP", link: "/php/how-to/build-process#customise-php-build-environment" }, + { name: "Python", link: "/python/how-to/build-process#customise-python-build-environment" }, + { name: "Go", link: "/go/how-to/build-process#customise-go-build-environment" }, + { name: ".NET", link: "/dotnet/how-to/build-process#customise-dotnet-build-environment" }, + { name: "Rust", link: "/rust/how-to/build-process#customise-rust-build-environment" }, + { name: "Java", link: "/java/how-to/build-process#customise-java-build-environment" }, +] + +export const customiseRuntime = [ + { name: "Node.js", link: "/nodejs/how-to/customize-runtime" }, + { name: "PHP", link: "/php/how-to/customize-runtime" }, + { name: "Python", link: "/python/how-to/customize-runtime" }, + { name: "Go", link: "/go/how-to/customize-runtime" }, + { name: ".NET", link: "/dotnet/how-to/customize-runtime" }, + { name: "Rust", link: "/rust/how-to/customize-runtime" }, + { name: "Java", link: "/java/how-to/customize-runtime" }, +] + ## Configure the pipeline Zerops provides a customizable build and runtime environment for your application. @@ -40,13 +80,7 @@ Zerops will follow these instruction when the build & deploy pipeline is trigger Learn more about all `zerops.yml` parameters for your runtime: -- [Node.js](/nodejs/how-to/build-pipeline) -- [PHP](/php/how-to/build-pipeline) -- [Python](/python/how-to/build-pipeline) -- [Go](/go/how-to/build-pipeline) -- [.NET](/dotnet/how-to/build-pipeline) -- [Rust](/rust/how-to/build-pipeline) -- [Java](/java/how-to/build-pipeline) + ## Trigger the pipeline @@ -132,13 +166,8 @@ The build container is automatically deleted after the build has finished or fai Each runtime service have different HW resources for build containers: -- [Node.js](/nodejs/how-to/build-process##nodejs-build-hardware-resources) -- [PHP](/php/how-to/build-process#php-build-hardware-resources) -- [Python](/python/how-to/build-process#python-build-hardware-resources) -- [Go](/go/how-to/build-process#go-build-hardware-resources) -- [.NET](/dotnet/how-to/build-process#dotnet-build-hardware-resources) -- [Rust](/rust/how-to/build-process#rust-build-hardware-resources) -- [Java](/java/how-to/build-process#java-build-hardware-resources) + + The build container is always started with the minimum hardware resources and scales vertically up to the maximum resources. @@ -157,13 +186,7 @@ To install additional packages or tools add one or more [build.prepareCommands]( Learn more about what is included in the default build environment: -- [Node.js](/nodejs/how-to/build-process#customise-nodejs-build-environment) -- [PHP](/php/how-to/build-process#customise-php-build-environment) -- [Python](/python/how-to/build-process#customise-python-build-environment) -- [Go](/go/how-to/build-process#customise-go-build-environment) -- [.NET](/dotnet/how-to/build-process#customise-dotnet-build-environment) -- [Rust](/rust/how-to/build-process#customise-rust-build-environment) -- [Java](/java/how-to/build-process#customise-java-build-environment) + ## Deploy phase @@ -248,13 +271,7 @@ To install additional packages or tools add one or more [run.prepareCommands](/r Learn more about what is included in the default runtime environment: -- [Node.js](/nodejs/how-to/customize-runtime) -- [PHP](/php/how-to/customize-runtime) -- [Python](/python/how-to/customize-runtime) -- [Go](/go/how-to/customize-runtime) -- [.NET](/dotnet/how-to/customize-runtime) -- [Rust](/rust/how-to/customize-runtime) -- [Java](/java/how-to/customize-runtime) +

+ + + Parameter + Description + + + + + port + Defines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems. + + + protocol + Optional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP. + + + httpSupport + Optional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol. + + + + ### prepareCommands @@ -724,9 +743,25 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/go/how-to/create#set-environment-variables) as your Go application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Go application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** @@ -803,9 +838,24 @@ Read more about how the [readiness check works](/go/how-to/deploy-process#readin Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/go/how-to/create#set-environment-variables) as your Go application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Go application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/go/how-to/create.mdx b/apps/docs/content/go/how-to/create.mdx index fd33ca7e..6e9a65ce 100644 --- a/apps/docs/content/go/how-to/create.mdx +++ b/apps/docs/content/go/how-to/create.mdx @@ -77,11 +77,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Go service always starts with the minimal resources. @@ -250,143 +272,98 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | - -At least one service in `services:` section is required. You can create a project with multiple services. The example above contains Go and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - - - - - - - - - - - - - - +
ParameterDescription
- hostname - - The unique service identifier.

The hostname of the new database will be set to the `hostname` value.

Limitations:
- duplicate services with the same name in the same project are forbidden
- - maximum 25 characters
- - must contain only lowercase ASCII letters (a-z) or numbers (0-9) -
+ - - + + - -{" "} - - - - - - - - - - - - - - - - - - - - - - -{" "} - - - - - - -{" "} - - - - - - -{" "} - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
typeSpecifies the service type `go` and version.
Set type: `go@<version>` or `go@latest`

Limitations:
Following Go major versions are currently supported: 1.22
ParameterDescription
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified attributes - will be set to their default values. -
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED` values. - Default is `SHARED` -
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). -
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). -
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). -
- minContainers - - Optional. Default = 1. Defines the minimum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: -
- Current maximum value = 6. -
- maxContainers - - Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: -
- Current maximum value = 6. -
- envSecrets - - Optional. Defines one or more secret env variables as a key value - map. See env variable{' '} - - restrictions - - . -
hostname + The unique service identifier. + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
type + Specifies the service type `go` and version. +
+ Set type: `go@` or `go@latest` + + Limitations: +
+ Following Go major versions are currently supported: 1.22 +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values. +
- cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED` +
- minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer). +
- minRam/maxRam + Optional. Set the minRam or maxRam in GB (float). +
- minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float). +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations: +
+ Current maximum value = 6. +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations: +
+ Current maximum value = 6. +
envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions. +
### Create a project based on the description.yml diff --git a/apps/docs/content/go/how-to/env-variables.mdx b/apps/docs/content/go/how-to/env-variables.mdx index 703edf7e..60e2f25b 100644 --- a/apps/docs/content/go/how-to/env-variables.mdx +++ b/apps/docs/content/go/how-to/env-variables.mdx @@ -11,11 +11,33 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | ----------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/go/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/go/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/go/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
+ Use the [secret env variables](/go/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/go/how-to/scaling.mdx b/apps/docs/content/go/how-to/scaling.mdx index d76bc6c8..0b6803bd 100644 --- a/apps/docs/content/go/how-to/scaling.mdx +++ b/apps/docs/content/go/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Go service always starts with the minimal resources. diff --git a/apps/docs/content/java/how-to/build-pipeline.mdx b/apps/docs/content/java/how-to/build-pipeline.mdx index a997c29a..b8c5d904 100644 --- a/apps/docs/content/java/how-to/build-pipeline.mdx +++ b/apps/docs/content/java/how-to/build-pipeline.mdx @@ -500,11 +500,30 @@ For example, to connect to a Java service with hostname = "app" and port = 8080 Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
+ ### prepareCommands @@ -720,9 +739,24 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/java/how-to/create#set-environment-variables) as your Java application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Java application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** @@ -799,9 +833,24 @@ Read more about how the [readiness check works](/java/how-to/deploy-process#read Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/java/how-to/create#set-environment-variables) as your Java application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Java application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/java/how-to/create.mdx b/apps/docs/content/java/how-to/create.mdx index a3529072..3d7451ea 100644 --- a/apps/docs/content/java/how-to/create.mdx +++ b/apps/docs/content/java/how-to/create.mdx @@ -77,11 +77,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Java service always starts with the minimal resources. @@ -250,131 +272,98 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | - -At least one service in `services:` section is required. You can create a project with multiple services. The example above contains Java and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - - - - - - - - - - -
ParameterDescription
- hostname + + + + + + + + + + + - - - + - - + + - -{" "} - - - - - - - - - - - - - - - - - - - - - - -{" "} - - - - - - -{" "} - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
hostname + The unique service identifier. + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- The unique service identifier.

The hostname of the new database will be set to the `hostname` value.

Limitations:
- duplicate services with the same name in the same project are forbidden
- - maximum 25 characters
- - must contain only lowercase ASCII letters (a-z) or numbers (0-9) -
typeSpecifies the service type `java` and version.
Set type: `java@<version>` or `java@latest`

Limitations:
Following Java major versions are currently supported: 1.22
type + Specifies the service type `java` and version. +
+ Set type: `java@` or `java@latest` + + Limitations: +
+ Following Java major versions are currently supported: 1.22 +
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified attributes - will be set to their default values. -
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED` values. - Default is `SHARED` -
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). -
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). -
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). -
- minContainers - - Defines the minimum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: -
- Current maximum value = 6. -
- maxContainers - - Optional. Default = 1. Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: -
- Current maximum value = 6. -
envSecretsOptional. Defines one or more secret env variables as a key value map. See env variable restrictions.
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values. +
- cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED` +
- minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer). +
- minRam/maxRam + Optional. Set the minRam or maxRam in GB (float). +
- minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float). +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations: +
+ Current maximum value = 6. +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations: +
+ Current maximum value = 6. +
envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions. +
### Create a project based on the description.yml diff --git a/apps/docs/content/java/how-to/env-variables.mdx b/apps/docs/content/java/how-to/env-variables.mdx index 522c0f08..8b69837d 100644 --- a/apps/docs/content/java/how-to/env-variables.mdx +++ b/apps/docs/content/java/how-to/env-variables.mdx @@ -11,11 +11,33 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | ------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/java/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/java/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/java/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
+ Use the [secret env variables](/java/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/java/how-to/scaling.mdx b/apps/docs/content/java/how-to/scaling.mdx index 19015391..1580a4a0 100644 --- a/apps/docs/content/java/how-to/scaling.mdx +++ b/apps/docs/content/java/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Java service always starts with the minimal resources. diff --git a/apps/docs/content/keydb/how-to/create.mdx b/apps/docs/content/keydb/how-to/create.mdx index dfa00be2..84a70f17 100644 --- a/apps/docs/content/keydb/how-to/create.mdx +++ b/apps/docs/content/keydb/how-to/create.mdx @@ -11,9 +11,26 @@ First, set up a project in Zerops GUI. Then go to the project dashboard page and **// TODO screenshot (add a new service page)** -| Parameter | Description | Limitations | -| ------------ | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | A unique service identifier like `keydb`, `db` etc. | - duplicate services with the same name in the same project are forbidden
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) | + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
hostnameA unique service identifier like `keydb`, `db` etc. +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
:::caution The hostname is fixed after the service is created. It can't be changed later. @@ -81,11 +98,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ For most cases, the default parameters will work without issues. If you need to limit the cost of the KeyDB service, lower the maximal resources. Zerops will never scale above the selected maximums. @@ -189,136 +228,117 @@ The hostname of the second service will be set to `keydb2`. The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains only KeyDB services but you can create a `description.yml` with [different types] of services. - +
- - + + - - + - - + - - - + - - + - - + - - + - - + - - + diff --git a/apps/docs/content/keydb/how-to/scale.mdx b/apps/docs/content/keydb/how-to/scale.mdx index f689fecd..f4b4b549 100644 --- a/apps/docs/content/keydb/how-to/scale.mdx +++ b/apps/docs/content/keydb/how-to/scale.mdx @@ -38,11 +38,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | +
ParameterDescriptionParameterDescription
- hostname - + hostname The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - + type Specifies the service type `keydb` and version.
- Set type:{' '} - ` - keydb@XXX - ` -
- Currently only KeyDB XXX is available. + Set type: `keydb@6` + + Limitations: +
+ Currently only KeyDB 6 is available.
- mode - + mode Defines the operation mode of KeyDB service. + + HA
+ Creates a KeyDB cluster with 2 database containers. This mode is suited for production. + + Zerops always keeps the 2 database containers on different physical machines. All your data is stored redundantly in 2 identical copies. In case of a failure of a container or the underlying physical machine, Zerops automatically disconnects the failed container from the cluster, creates a new container and syncs all data from the remaining copy. Finally the broken container is automatically deleted. + + NON_HA
- HA -
- Creates a KeyDB cluster with 2 database containers. This mode is suited - for production. -
-
- Zerops always keeps the 2 database containers on different physical - machines. All your data is stored redundantly in 2 identical copies. In - case of a failure of a container or the underlying physical machine, - Zerops automatically disconnects the failed container from the cluster, - creates a new container and syncs all data from the remaining copy. - Finally the broken container is automatically deleted. -
-
- NON_HA -
- Zerops will create a KeyDB database installed in a single container. - Useful for non-essential data or dev environments. -
-
- Your data is stored only in a single container. If the container or the - underlying physical machine fails, your data since the last backup are - lost. Zerops doesn't provide any automatic repairs of single node KeyDB - services. + Zerops will create a KeyDB database installed in a single container. Useful for non-essential data or dev environments. + + Your data is stored only in a single container. If the container or the underlying physical machine fails, your data since the last backup are lost. Zerops doesn't provide any automatic repairs of single node KeyDB services.
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified - attributes will be set to their default values. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` + - cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). + - minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). + - minRam/maxRam + Optional. Set the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). + - minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float).
+ + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ For most cases, the default parameters will work without issues. If you need to limit the cost of the KeyDB service, lower the maximal resources. Zerops will never scale above the selected maximums. diff --git a/apps/docs/content/mariadb/how-to/create.mdx b/apps/docs/content/mariadb/how-to/create.mdx index ced27c65..5ae31620 100644 --- a/apps/docs/content/mariadb/how-to/create.mdx +++ b/apps/docs/content/mariadb/how-to/create.mdx @@ -15,9 +15,27 @@ First, set up a project in Zerops GUI. Then go to the project dashboard page and **// TODO screenshot (add a new service page)** -| Parameter | Description | Limitations | -| ------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | A unique service identifier like `mariadb`,`sql`, `db` etc. | - duplicate services with the same name in the same project are forbidden
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) | + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
hostnameA unique service identifier like `mariadb`,`sql`, `db` etc. +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
+ :::caution The hostname is fixed after the service is created. It can't be changed later. @@ -83,11 +101,32 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.5 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.5 GB32 GB
Disk1 GB100 GB
For most cases, the default parameters will work without issues. If you need to limit the cost of the MariaDB service, lower the maximal resources. Zerops will never scale above the selected maximums. @@ -191,67 +230,71 @@ The hostname of the second service will be set to `mariadb2`. The [single contai The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains only MariaDB services but you can create a `description.yml` with [different types] of services. - +
- - + + + - - + + - - + + - - + + - - + + - - + + + - - + + + - - + + + - - + + +
ParameterDescriptionParameterDescriptionLimitations
- hostname - - The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters +
hostnameA unique service identifier like `mariadb`,`sql`, `db` etc. + - duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - - Specifies the service type `mariadb` and version. -
+
typeSpecifies the service type `mariadb` and version. Set type:{' '} ` mariadb@10.4 `

- Limitations: -
Currently only MariaDB 10.4 is available.
- mode - - Defines the operation mode of MariaDB service. -
-
+
modeDefines the operation mode of MariaDB service. HA
Zerops will create a MariaDB cluster with 3 database containers and 2 @@ -266,12 +309,6 @@ At least one service in `services:` section is required. You can create a projec the broken container is automatically deleted.

- Limitations: -
- Learn more about - specific behaviour and technical limitations of the MariaDB cluster. -
-
NON_HA
Zerops will create a MariaDB database installed in a single container. @@ -285,51 +322,32 @@ At least one service in `services:` section is required. You can create a projec
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
+
verticalAutoscalingDefines custom vertical auto scaling parameters All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` - - cpuModeAccepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). - - minCpu/maxCpuSet the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). - - minRam/maxRamSet the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). - - minDisk/maxDiskSet the minDisk or maxDisk in GB (float).
diff --git a/apps/docs/content/nginx/how-to/build-pipeline.mdx b/apps/docs/content/nginx/how-to/build-pipeline.mdx index 59e3d159..b4457b33 100644 --- a/apps/docs/content/nginx/how-to/build-pipeline.mdx +++ b/apps/docs/content/nginx/how-to/build-pipeline.mdx @@ -5,18 +5,23 @@ description: Learn more about how you can configure your nginx service for build import data from '@site/static/data.json'; import UnorderedCodeList from '@site/src/components/UnorderedCodeList'; +import GroupCards from '@site/src/components/GroupCards'; + +export const languages = [ + { name: "Node.js", link: "/nodejs/how-to/build-pipeline" }, + { name: "PHP", link: "/php/how-to/build-pipeline" }, + { name: "Python", link: "/python/how-to/build-pipeline" }, + { name: "Go", link: "/go/how-to/build-pipeline" }, + { name: ".NET", link: "/dotnet/how-to/build-pipeline" }, + { name: "Rust", link: "/rust/how-to/build-pipeline" }, + { name: "Java", link: "/java/how-to/build-pipeline" }, +] Zerops provides a customizable build and runtime environment for your static content. Zerops supports different build environments: -- [Node.js](/nodejs/how-to/build-pipeline) -- [PHP](/php/how-to/build-pipeline) -- [Python](/python/how-to/build-pipeline) -- [Go](/go/how-to/build-pipeline) -- [.NET](/dotnet/how-to/build-pipeline) -- [Rust](/rust/how-to/build-pipeline) -- [Java](/java/how-to/build-pipeline) + If you just need to deploy your static content, use the [manual deploy](/nginx/how-to/trigger-pipeline#manual-deploy-using-zerops-cli) via Zerops CLI. @@ -106,20 +111,6 @@ zerops: Each service configuration contains at least two sections: **build** and **run**. Both sections are required to build and deploy your Nginx application in Zerops. If you'd like to use a readiness check, add an optional **deploy** section. -## Build pipeline configuration - -Zerops supports different build environments: - -- [Node.js](/nodejs/how-to/build-pipeline) -- [PHP](/php/how-to/build-pipeline) -- [Python](/python/how-to/build-pipeline) -- [Go](/go/how-to/build-pipeline) -- [.NET](/dotnet/how-to/build-pipeline) -- [Rust](/rust/how-to/build-pipeline) -- [Java](/java/how-to/build-pipeline) - -If you just need to deploy your static content, use the [manual deploy](/nginx/how-to/trigger-pipeline#manual-deploy-using-zerops-cli) via Zerops CLI. - ## Runtime configuration ### base @@ -227,11 +218,28 @@ Do not use the port **:443**. All the incoming traffic is terminated on the Zero Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
### prepareCommands @@ -473,9 +481,24 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/nginx/how-to/create#set-environment-variables) as your Nginx application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Nginx application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** @@ -553,9 +576,24 @@ Read more about how the [readiness check works](/nginx/how-to/deploy-process#rea Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/nginx/how-to/create#set-environment-variables) as your Nginx application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Nginx application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/nginx/how-to/create.mdx b/apps/docs/content/nginx/how-to/create.mdx index e7012d53..b93d2dba 100644 --- a/apps/docs/content/nginx/how-to/create.mdx +++ b/apps/docs/content/nginx/how-to/create.mdx @@ -77,11 +77,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Nginx static service always starts with the minimal resources. @@ -240,11 +262,33 @@ S3_ACCESS_SECRET="ogFthuiLYki8XoL73opSCQ" The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains an Nginx static service but you can create a `description.yml` with your own combination of [services](/features/infrastructure). diff --git a/apps/docs/content/nginx/how-to/env-variables.mdx b/apps/docs/content/nginx/how-to/env-variables.mdx index 3f93bfc1..01362ea4 100644 --- a/apps/docs/content/nginx/how-to/env-variables.mdx +++ b/apps/docs/content/nginx/how-to/env-variables.mdx @@ -11,11 +11,33 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | -------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/nginx/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/nginx/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/nginx/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
+ Use the [secret env variables](/nginx/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/nginx/how-to/scaling.mdx b/apps/docs/content/nginx/how-to/scaling.mdx index cb975b6c..9b053e4d 100644 --- a/apps/docs/content/nginx/how-to/scaling.mdx +++ b/apps/docs/content/nginx/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Nginx static service always starts with the minimal resources. diff --git a/apps/docs/content/nodejs/how-to/build-pipeline.mdx b/apps/docs/content/nodejs/how-to/build-pipeline.mdx index 8ea6a483..886efcc8 100644 --- a/apps/docs/content/nodejs/how-to/build-pipeline.mdx +++ b/apps/docs/content/nodejs/how-to/build-pipeline.mdx @@ -512,11 +512,28 @@ For example, to connect to a Node.js service with hostname = "app" and port = 30 Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
### prepareCommands @@ -735,9 +752,24 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/nodejs/how-to/create#set-environment-variables) as your Node.js application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Node.js application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** @@ -814,9 +846,24 @@ Read more about how the [readiness check works](/nodejs/how-to/deploy-process#re Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/nodejs/how-to/create#set-environment-variables) as your Node.js application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Node.js application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/nodejs/how-to/create.mdx b/apps/docs/content/nodejs/how-to/create.mdx index 7dce4a57..ee87a709 100644 --- a/apps/docs/content/nodejs/how-to/create.mdx +++ b/apps/docs/content/nodejs/how-to/create.mdx @@ -87,11 +87,32 @@ You can choose the CPU mode when starting a new service or change it later. The Vertical auto scaling has the following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
Node.js services always start with the minimal resources. @@ -113,19 +134,21 @@ When a container needs more CPU or RAM but is already consuming the maximum reso Horizontal auto scaling has the following default configuration: - +
+ + + + + + - - + + - - + +
ParameterValue
- Minimum containers - 1Minimum containers1
- Maximum containers - 6Maximum containers6
@@ -259,155 +282,124 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
At least one service in `services:` section is required. You can create a project with multiple services. The example above contains Node.js and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - +
- - + + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + diff --git a/apps/docs/content/nodejs/how-to/env-variables.mdx b/apps/docs/content/nodejs/how-to/env-variables.mdx index 74dff90f..d62ac85a 100644 --- a/apps/docs/content/nodejs/how-to/env-variables.mdx +++ b/apps/docs/content/nodejs/how-to/env-variables.mdx @@ -11,11 +11,32 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | --------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/nodejs/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/nodejs/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/nodejs/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | +
ParameterDescriptionParameterDescription
- hostname - + hostname The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters + + The hostname of the new database will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - + type Specifies the service type `nodejs` and version.
- Set type:{' '} - ` - nodejs@<version> - `{' '} - or{' '} - ` - nodejs@latest - ` -
+ Set type: `nodejs@` or `nodejs@latest` + + Limitations:
- Limitations: -
- Following Node.js major versions are currently supported: 20, - 18,16 + Following Node.js major versions are currently supported: 20, 18, 16
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified - attributes will be set to their default values. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` + - cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). + - minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). + - minRam/maxRam + Optional. Set the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). + - minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float).
- minContainers - - Optional. Default = 1. Defines the minimum number of containers - for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- maxContainers - - Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- envSecrets - - Optional. Defines one or more secret env variables as a key value - map. See env variable{' '} - - restrictions - - . + envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions.
+ + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
Use the [secret env variables](/nodejs/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/nodejs/how-to/scaling.mdx b/apps/docs/content/nodejs/how-to/scaling.mdx index a51d950b..33fe4088 100644 --- a/apps/docs/content/nodejs/how-to/scaling.mdx +++ b/apps/docs/content/nodejs/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Node.js service always starts with the minimal resources. diff --git a/apps/docs/content/object-storage/how-to/create.mdx b/apps/docs/content/object-storage/how-to/create.mdx index 42eee182..b036b89f 100644 --- a/apps/docs/content/object-storage/how-to/create.mdx +++ b/apps/docs/content/object-storage/how-to/create.mdx @@ -53,13 +53,58 @@ Bucket will be created with a name based on the given service name and a random Select one of the basic policy templates: -| Template | Description | -| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Public read | Allows anyone:
  • to read the bucket's location `(s3:GetBucketLocation)`
  • to list all bucket's objects `(s3:ListBucket)`
  • to get any object of the bucket `(s3:GetObject)`
| -| Public objects read | Allows anyone:
  • to read the bucket's location `(s3:GetBucketLocation)`
  • to get any object of the bucket `(s3:GetObject)`
| -| Public read write | Allows anyone:
  • to read the bucket's location `(s3:GetBucketLocation)`
  • to list all bucket's objects `(s3:ListBucket)`
  • to get any object of the bucket `(s3:GetObject)`
  • to create a new object in the bucket `(s3:PutObject,s3:ListMultipartUploadParts, s3:AbortMultipartUpload, s3:ListBucketMultipartUploads)`
  • to delete any object of the bucket `(s3:DeleteObject)`
| -| Public write | Allows anyone to create objects in the bucket `(PutObject action)` | -| Private | Denies the access to unauthenticated users. | + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TemplateDescription
Public read + Allows anyone: +
    +
  • to read the bucket's location `(s3:GetBucketLocation)`
  • +
  • to list all bucket's objects `(s3:ListBucket)`
  • +
  • to get any object of the bucket `(s3:GetObject)`
  • +
+
Public objects read + Allows anyone: +
    +
  • to read the bucket's location `(s3:GetBucketLocation)`
  • +
  • to get any object of the bucket `(s3:GetObject)`
  • +
+
Public read write + Allows anyone: +
    +
  • to read the bucket's location `(s3:GetBucketLocation)`
  • +
  • to list all bucket's objects `(s3:ListBucket)`
  • +
  • to get any object of the bucket `(s3:GetObject)`
  • +
  • to create a new object in the bucket `(s3:PutObject,s3:ListMultipartUploadParts, s3:AbortMultipartUpload, s3:ListBucketMultipartUploads)`
  • +
  • to delete any object of the bucket `(s3:DeleteObject)`
  • +
+
Public writeAllows anyone to create objects in the bucket `(PutObject action)`
PrivateDenies the access to unauthenticated users.
Or you can set your own access policy in the [IAM Policy JSON format](https://min.io/docs/minio/linux/administration/identity-access-management/policy-based-access-control.html#policy-document-structure). @@ -159,21 +204,106 @@ The yaml file describes your future project infrastructure. The project will con The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -| **name** | The name of the new project. Duplicates are allowed. | Maximum 255 characters | -| **description** | **Optional.** Description of the new project. | | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.Maximum 255 characters
descriptionOptional. Description of the new project.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
At least one service in `services:` section is required. You can create a project with multiple services. The example above contains only Object storage service but you can create a description.yml with different types of services. -| Parameter | Description | -| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | The unique service identifier.
The name of the new Object storage will be set to the hostname value.
**Limitations:**
  • duplicate services with the same name in the same project are forbidden
  • maximum 25 characters
  • must contain only lowercase ASCII letters (a-z) or numbers (0-9)
| -| **type** | Specifies the Object storage type objectstorage and version.
Set type: `objectstorage`
**Limitations:** Currently `objectstorage` or `object-storage` is available. | -| **objectStorageSize** | The size of the bucket quota in GB.
**Limitations:** Set a whole number between 1 and 100. | -| **objectStoragePolicy** | **Optional.** Either `objectStoragePolicy` or `objectStorageRawPolicy` is required.
Set one of allowed values:
  • `public-read`
  • `public-objects-read`
  • `public-read-write`
  • `public-write`
  • `private`
Read more about [the basic policy templates]. | -| **objectStorageRawPolicy** | **Optional.** Either `objectStoragePolicy` or `objectStorageRawPolicy` is required.
Set your own access policy in the [IAM Policy JSON format].
The `{{ .BucketName }}` variable will be replaced by the bucket name. | + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
hostname + The unique service identifier. + + The name of the new Object storage will be set to the hostname value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
type + Specifies the Object storage type objectstorage and version. +
+ Set type: `objectstorage` + + Limitations: +
+ Currently `objectstorage` or `object-storage` is available. +
objectStorageSize + The size of the bucket quota in GB. + + Limitations: +
+ Set a whole number between 1 and 100. +
objectStoragePolicy + Optional. Either `objectStoragePolicy` or `objectStorageRawPolicy` is required. + + Set one of allowed values: +
    +
  • `public-read`
  • +
  • `public-objects-read`
  • +
  • `public-read-write`
  • +
  • `public-write`
  • +
  • `private`
  • +
+ Read more about the basic policy templates. +
objectStorageRawPolicy + Optional. Either `objectStoragePolicy` or `objectStorageRawPolicy` is required. + + Set your own access policy in the IAM Policy JSON format. + + The `{{ .BucketName }}` variable will be replaced by the bucket name. +
Zerops creates one bucket automatically for each new Object storage service. diff --git a/apps/docs/content/php/how-to/build-pipeline.mdx b/apps/docs/content/php/how-to/build-pipeline.mdx index c12a5a30..278ca3df 100644 --- a/apps/docs/content/php/how-to/build-pipeline.mdx +++ b/apps/docs/content/php/how-to/build-pipeline.mdx @@ -519,11 +519,28 @@ Do not use the port **:443**. All the incoming traffic is terminated on the Zero Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
### prepareCommands @@ -766,9 +783,24 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/php/how-to/create#set-environment-variables) as your PHP application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your PHP application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** @@ -846,9 +878,24 @@ Read more about how the [readiness check works](/php/how-to/deploy-process#readi Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/php/how-to/create#set-environment-variables) as your PHP application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your PHP application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
**Example:** diff --git a/apps/docs/content/php/how-to/create.mdx b/apps/docs/content/php/how-to/create.mdx index dd3bc477..2176f998 100644 --- a/apps/docs/content/php/how-to/create.mdx +++ b/apps/docs/content/php/how-to/create.mdx @@ -77,11 +77,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ PHP service always starts with the minimal resources. @@ -103,19 +125,21 @@ When a container needs more CPU or RAM but already consumes maximal resources de Horizontal auto scaling has following default configuration: - +
+ + + + + + - - + + - - + +
ParameterValue
- minimum containers - 1minimum containers1
- maximum containers - 6maximum containers6
@@ -250,164 +274,125 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains PHP and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - +
- - + + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + diff --git a/apps/docs/content/php/how-to/env-variables.mdx b/apps/docs/content/php/how-to/env-variables.mdx index c6528435..0e4cd5a8 100644 --- a/apps/docs/content/php/how-to/env-variables.mdx +++ b/apps/docs/content/php/how-to/env-variables.mdx @@ -11,11 +11,33 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | ------------------------------------------------------------------------------ | -| build | basic | [zerops.yml](/php/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/php/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/php/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | +
ParameterDescriptionParameterDescription
- hostname - + hostname The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters + + The hostname of the new service will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - - Specifies the service type `php-apache` or{' '} - `php-nginx` and version. -
- Set type:{' '} - ` - php-apache@<version> - ` - ,{' '} - ` - php-nginx@<version> - ` - ,{' '} - ` - php-apache@latest - `{' '} - or{' '} - ` - php-nginx@latest - ` +
type + Specifies the service type `php-apache` or `php-nginx` and version.
+ Set type: `php-apache@`, `php-nginx@`, `php-apache@latest` or `php-nginx@latest` + + Limitations:
- Limitations: -
- Following PHP major versions are currently supported: 7.4, - 8.0,8.1 + Following PHP major versions are currently supported: 7.4, 8.0, 8.1
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified - attributes will be set to their default values. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` + - cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). + - minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). + - minRam/maxRam + Optional. Set the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). + - minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float).
- minContainers - - Optional. Default = 1. Defines the minimum number of containers - for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- maxContainers - - Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- envSecrets - - Optional. Defines one or more secret env variables as a key value - map. See env variable{' '} - - restrictions - - . + envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions.
+ + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
+ Use the [secret env variables](/php/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/php/how-to/scaling.mdx b/apps/docs/content/php/how-to/scaling.mdx index 28b41ff8..19f8bb6c 100644 --- a/apps/docs/content/php/how-to/scaling.mdx +++ b/apps/docs/content/php/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ PHP service always starts with the minimal resources. diff --git a/apps/docs/content/postgresql/how-to/create.mdx b/apps/docs/content/postgresql/how-to/create.mdx index 2d38176b..10a90afc 100644 --- a/apps/docs/content/postgresql/how-to/create.mdx +++ b/apps/docs/content/postgresql/how-to/create.mdx @@ -11,9 +11,26 @@ First, set up a project in Zerops GUI. Then go to the project dashboard page and **// TODO screenshot (add a new service page)** -| Parameter | Description | Limitations | -| ------------ | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | A unique service identifier like `postgresql`,`sql`, `db` etc. | - duplicate services with the same name in the same project are forbidden
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) | + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
hostnameA unique service identifier like `postgresql`,`sql`, `db` etc. + - duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
:::caution The hostname is fixed after the service is created. It can't be changed later. @@ -189,11 +206,33 @@ The hostname of the second service will be set to `postgresql2`. The [single con The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in the `services:` section is required. You can create a project with multiple services. The example above contains only PostgreSQL services but you can create a `description.yml` with [different types] of services. diff --git a/apps/docs/content/python/how-to/build-pipeline.mdx b/apps/docs/content/python/how-to/build-pipeline.mdx index c190478c..913d7b32 100644 --- a/apps/docs/content/python/how-to/build-pipeline.mdx +++ b/apps/docs/content/python/how-to/build-pipeline.mdx @@ -461,11 +461,28 @@ For example, to connect to a Python service with hostname = "app" and port = 800 Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
### prepareCommands @@ -681,9 +698,26 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/python/how-to/create#set-environment-variables) as your Python application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Python application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** @@ -760,9 +794,26 @@ Read more about how the [readiness check works](/python/how-to/deploy-process#re Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/python/how-to/create#set-environment-variables) as your Python application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Python application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** diff --git a/apps/docs/content/python/how-to/create.mdx b/apps/docs/content/python/how-to/create.mdx index f72a6b02..a9451494 100644 --- a/apps/docs/content/python/how-to/create.mdx +++ b/apps/docs/content/python/how-to/create.mdx @@ -77,11 +77,32 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 5 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk5 GB100 GB
Python service always starts with the minimal resources. @@ -103,19 +124,21 @@ When a container needs more CPU or RAM but already consumes maximal resources de Horizontal auto scaling has following default configuration: - +
+ + + + + + - - + + - - + +
ParameterValue
- minimum containers - 1minimum containers1
- maximum containers - 6maximum containers6
@@ -250,155 +273,125 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains Python and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). - +
- - + + - - + - - + - - + - - + - - + - - + - - + - - + - - + - - + diff --git a/apps/docs/content/python/how-to/env-variables.mdx b/apps/docs/content/python/how-to/env-variables.mdx index 33f5d098..4fba2d41 100644 --- a/apps/docs/content/python/how-to/env-variables.mdx +++ b/apps/docs/content/python/how-to/env-variables.mdx @@ -11,11 +11,33 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | --------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/python/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/python/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/python/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | +
ParameterDescriptionParameterDescription
- hostname - + hostname The unique service identifier. -
-
- The hostname of the new database will be set to the{' '} - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters + + The hostname of the new service will be set to the `hostname` value. + + Limitations: +
- duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - + type Specifies the service type `python` and version.
- Set type:{' '} - ` - python@<version> - `{' '} - or{' '} - ` - python@latest - ` + Set type: `python@` or `python@latest` + + Limitations:
-
- Limitations: -
- Following Python major versions are currently supported: 3.8, - 3.9,3.10,3.11,3.12 + Following Python major versions are currently supported: 3.8, 3.9, 3.10, 3.11, 3.12
- verticalAutoscaling - - Optional. Defines{' '} - - custom vertical auto scaling parameters - - .
- All verticalAutoscaling attributes are optional. Not specified - attributes will be set to their default values. +
verticalAutoscaling + Optional. Defines custom vertical auto scaling parameters. +
+ All verticalAutoscaling attributes are optional. Not specified attributes will be set to their default values.
- - cpuMode - - Optional. Accepts `SHARED`, `DEDICATED`{' '} - values. Default is `SHARED` + - cpuMode + Optional. Accepts `SHARED`, `DEDICATED` values. Default is `SHARED`
- - minCpu/maxCpu - - Optional. Set the minCpu or maxCpu in CPU cores (integer). + - minCpu/maxCpu + Optional. Set the minCpu or maxCpu in CPU cores (integer).
- - minRam/maxRam - - Optional. Set the minRam or maxRam in GB (float). + - minRam/maxRam + Optional. Set the minRam or maxRam in GB (float).
- - minDisk/maxDisk - - Optional. Set the minDisk or maxDisk in GB (float). + - minDisk/maxDisk + Optional. Set the minDisk or maxDisk in GB (float).
- minContainers - - Optional. Default = 1. Defines the minimum number of containers - for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
minContainers + Optional. Default = 1. Defines the minimum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- maxContainers - - Defines the maximum number of containers for{' '} - - horizontal autoscaling - - .
-
- Limitations: +
maxContainers + Defines the maximum number of containers for horizontal autoscaling. + + Limitations:
Current maximum value = 6.
- envSecrets - - Optional. Defines one or more secret env variables as a key value - map. See env variable{' '} - - restrictions - - . + envSecrets + Optional. Defines one or more secret env variables as a key value map. See env variable restrictions.
+ + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
+ Use the [secret env variables](/python/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/python/how-to/scaling.mdx b/apps/docs/content/python/how-to/scaling.mdx index 7d56029b..cc853e2b 100644 --- a/apps/docs/content/python/how-to/scaling.mdx +++ b/apps/docs/content/python/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Python service always starts with the minimal resources. diff --git a/apps/docs/content/rabbitmq/how-to/create.mdx b/apps/docs/content/rabbitmq/how-to/create.mdx index 76475c8a..9262c43a 100644 --- a/apps/docs/content/rabbitmq/how-to/create.mdx +++ b/apps/docs/content/rabbitmq/how-to/create.mdx @@ -11,9 +11,26 @@ First, set up a project in Zerops GUI. Then go to the project dashboard page and **// TODO screenshot (add a new service page)** -| Parameter | Description | Limitations | -| ------------ | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **hostname** | A unique service identifier like `rabbitmq`, `db` etc. | - duplicate services with the same name in the same project are forbidden
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) | + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
hostnameA unique service identifier like `rabbitmq`, `db` etc. + - duplicate services with the same name in the same project are forbidden +
- maximum 25 characters +
- must contain only lowercase ASCII letters (a-z) or numbers (0-9) +
:::caution The hostname is fixed after the service is created. It can't be changed later. @@ -58,11 +75,32 @@ Zerops scales the RabbitMQ services automatically by raising or lowering the har Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.5 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.5 GB32 GB
Disk1 GB100 GB
For most cases, the default parameters will work without issues. If you need to limit the cost of the RabbitMQ service, lower the maximal resources. Zerops will never scale above the selected maximums. @@ -162,103 +200,89 @@ The hostname of the second service will be set to `rabbitmq2`. The [single conta The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains only RabbitMQ services but you can create a `description.yml` with [different types] of services. - +
- - + + + - - + + - - + - - - + - - + -
ParameterDescriptionParameterDescriptionLimitations
- hostname - - The unique service identifier. -
-
- The hostname of the new service will be set to the - `hostname` value.
-
- Limitations: -
- duplicate services with the same name in the same project are - forbidden -
- - maximum 25 characters +
hostnameA unique service identifier like `rabbitmq`, `db` etc. + - duplicate services with the same name in the same project are forbidden +
- maximum 25 characters
- must contain only lowercase ASCII letters (a-z) or numbers (0-9)
- type - + type Specifies the service type `rabbitmq` and version.
- Set type:{' '} - ` - rabbitmq@XXX - ` -
- Currently only RabbitMQ XXX is available. + Set type: `rabbitmq@3` + + Limitations: +
+ Currently only RabbitMQ 3.9.13 is available.
- mode - + mode Defines the operation mode of RabbitMQ service. + + HA
+ Creates a RabbitMQ cluster with 3 message queue containers and 2 free database proxies. This mode is suited for production. + + Zerops always keeps the 3 message queue containers on different physical machines. All your data is stored redundantly in 3 identical copies. In case of a failure of a container or the underlying physical machine, Zerops automatically disconnects the failed container from the cluster, creates a new container and syncs all data from the remaining 2 copies. Finally the broken container is automatically deleted. + + NON_HA
- HA -
- Creates a RabbitMQ cluster with 3 message queue containers and 2 free - database proxies. This mode is suited for production. -
-
- Zerops always keeps the 3 message queue containers on different physical - machines. All your data is stored redundantly in 3 identical copies. In - case of a failure of a container or the underlying physical machine, - Zerops automatically disconnects the failed container from the cluster, - creates a new container and syncs all data from the remaining 2 copies. - Finally the broken container is automatically deleted. -
-
- NON_HA -
- Zerops will create a RabbitMQ message broker installed in a single - container. Useful for non-essential data or dev environments. -
-
- Your data is stored only in a single container. If the container or the - underlying physical machine fails, your data since the last backup are - lost. Zerops doesn't provide any automatic repairs of single node - RabbitMQ services. + Zerops will create a RabbitMQ message broker installed in a single container. Useful for non-essential data or dev environments. + + Your data is stored only in a single container. If the container or the underlying physical machine fails, your data since the last backup are lost. Zerops doesn't provide any automatic repairs of single node RabbitMQ services.
- verticalAutoscaling - - Optional. Defines{' '} - - custom auto scaling parameters - - . + verticalAutoscaling + Optional. Defines custom auto scaling parameters.
diff --git a/apps/docs/content/references/ssh.mdx b/apps/docs/content/references/ssh.mdx index 88322f92..1a550d1c 100644 --- a/apps/docs/content/references/ssh.mdx +++ b/apps/docs/content/references/ssh.mdx @@ -8,20 +8,20 @@ SSH access is available only for runtime services and web servers. Database services, message brokers, and object storage are not accessible via SSH. ::: -# Prerequisites +## Prerequisites Before establishing an SSH connection to your runtime service, you must first connect to the [Zerops VPN](/references/vpn). -# Setting Up Your Connection +## Setting Up Your Connection -## 1. Configure VPN Access +### 1. Configure VPN Access The [Zerops CLI (zCLI)](/references/cli) comes bundled with the [Zerops VPN](/references/vpn) client. To connect to your [Zerops project](/features/infrastructure#project): 1. [Install and configure zCLI](/references/cli) 2. [Initialize the Zerops VPN connection](/references/vpn#start-the-vpn) -## 2. Establish SSH Connection +### 2. Establish SSH Connection Once your VPN session is active, you can connect to any [service](/features/infrastructure#services--containers) using its hostname: @@ -45,7 +45,7 @@ Are you sure you want to continue connecting (yes/no/[fingerprint])? Type `yes` to trust the host and prevent future prompts. -# Advanced Connection Options +## Advanced Connection Options

image @@ -68,7 +68,7 @@ ssh node-id-1.runtime.app.zerops When using [HA mode](/features/scaling-ha), connecting to the service hostname will route you to a random container within that service. ::: -# Container Naming Conventions +## Container Naming Conventions Each container in your project has a unique hostname following these patterns: @@ -85,9 +85,9 @@ When your application [scales horizontally](https://docs.zerops.io/features/scal Never connect to containers using their local IP addresses, as these addresses are dynamic and may change. ::: -# Important Considerations +## Important Considerations -## Non-Persistent Changes +### Non-Persistent Changes SSH connections should not be used for making persistent changes to your service: diff --git a/apps/docs/content/references/zeropsyml.mdx b/apps/docs/content/references/zeropsyml.mdx index 007e663f..3ea937d2 100644 --- a/apps/docs/content/references/zeropsyml.mdx +++ b/apps/docs/content/references/zeropsyml.mdx @@ -5,22 +5,25 @@ description: Learn how you can configure your zerops yaml and use the available import data from '@site/static/data.json'; import UnorderedCodeList from '@site/src/components/UnorderedCodeList'; +import GroupCards from '@site/src/components/GroupCards'; + +export const languages = [ + { name: "Node.js", link: "/nodejs/how-to/build-pipeline" }, + { name: "PHP", link: "/php/how-to/build-pipeline" }, + { name: "Python", link: "/python/how-to/build-pipeline" }, + { name: "Go", link: "/go/how-to/build-pipeline" }, + { name: ".NET", link: "/dotnet/how-to/build-pipeline" }, + { name: "Rust", link: "/rust/how-to/build-pipeline" }, + { name: "Java", link: "/java/how-to/build-pipeline" }, + { name: "Nginx", link: "/nginx/how-to/build-pipeline" } +] The `zerops.yml` file is crucial for defining how Zerops should [build and deploy](/features/pipeline) your application. Add the `zerops.yml` file to the **root of your repository** and customize it to suit your application's needs. --- -## Quick Links to Runtime-Specific Guides - -- [Node.js](/nodejs/how-to/build-pipeline) -- [PHP](/php/how-to/build-pipeline) -- [Python](/python/how-to/build-pipeline) -- [Go](/go/how-to/build-pipeline) -- [.NET](/dotnet/how-to/build-pipeline) -- [Rust](/rust/how-to/build-pipeline) -- [Java](/java/how-to/build-pipeline) -- [nginx static](/nginx/how-to/build-pipeline) + ## Basic Structure diff --git a/apps/docs/content/rust/how-to/build-pipeline.mdx b/apps/docs/content/rust/how-to/build-pipeline.mdx index 6f8a68bf..ef169094 100644 --- a/apps/docs/content/rust/how-to/build-pipeline.mdx +++ b/apps/docs/content/rust/how-to/build-pipeline.mdx @@ -494,11 +494,30 @@ For example, to connect to a Rust service with hostname = "app" and port = 8080 Each port has following attributes: -| parameter | description | -| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| port | Defines the port number. You can set any port number between _10_ and _65435_. Ports outside this interval are reserved for internal Zerops systems. | -| protocol | **Optional.** Defines the protocol. Allowed values are `TCP` or `UDP`. Default value is `TCP`. | -| httpSupport | **Optional.** `httpSupport = true` is the default setting for TCP protocol. Set `httpSupport = false` if a web server isn't running on the port. Zerops uses this information for the configuration of [public access](/features/access). `httpSupport = true` is available only in combination with the TCP protocol. | + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescription
portDefines the port number. You can set any port number between 10 and 65435. Ports outside this interval are reserved for internal Zerops systems.
protocolOptional. Defines the protocol. Allowed values are TCP or UDP. Default value is TCP.
httpSupportOptional. httpSupport = true is the default setting for TCP protocol. Set httpSupport = false if a web server isn't running on the port. Zerops uses this information for the configuration of public access. httpSupport = true is available only in combination with the TCP protocol.
+ ### prepareCommands @@ -722,9 +741,26 @@ Read more about how the [health check works] in Zerops. Configures the health check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/rust/how-to/create#set-environment-variables) as your Rust application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Rust application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** @@ -801,9 +837,26 @@ Read more about how the [readiness check works](/rust/how-to/deploy-process#read Configures the readiness check to run a local command. Following attributes are available: -| Parameter | Description | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **command** | Defines a local command to be run.
The command has access to the same [environment variables](/rust/how-to/create#set-environment-variables) as your Rust application.
A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. | + + + + + + + + + + + + + + +
ParameterDescription
command + Defines a local command to be run.
+ The command has access to the same environment variables as your Rust application.
+ A single string is required. If you need to run multiple commands create a shell script or, use a multiline format as in the example below. +
+ **Example:** diff --git a/apps/docs/content/rust/how-to/create.mdx b/apps/docs/content/rust/how-to/create.mdx index 4227ca60..69f30bf4 100644 --- a/apps/docs/content/rust/how-to/create.mdx +++ b/apps/docs/content/rust/how-to/create.mdx @@ -77,11 +77,33 @@ Choose the CPU mode when starting a new service or change it later. The CPU mode Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Rust service always starts with the minimal resources. @@ -103,19 +125,21 @@ When a container needs more CPU or RAM but already consumes maximal resources de Horizontal auto scaling has following default configuration: - +
+ + + + + + - - + + - - + +
ParameterValue
- minimum containers - 1minimum containers1
- maximum containers - 6maximum containers6
@@ -250,11 +274,33 @@ The hostname of the PostgreSQL service will be set to "db". The [single containe The `project:` section is required. Only one project can be defined. -| Parameter | Description | Limitations | -| --------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | -| **name** | The name of the new project. Duplicates are allowed. | | -| **description** | **Optional.** Description of the new project. | Maximum 255 characters. | -| **tags** | **Optional.** One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects. | + + + + + + + + + + + + + + + + + + + + + + + + + +
ParameterDescriptionLimitations
nameThe name of the new project. Duplicates are allowed.
descriptionOptional. Description of the new project.Maximum 255 characters.
tagsOptional. One or more string tags. Tags do not have a functional meaning, they only provide better orientation in projects.
+ At least one service in `services:` section is required. You can create a project with multiple services. The example above contains Rust and PostgreSQL services but you can create a `description.yml` with your own combination of [services](/features/infrastructure). diff --git a/apps/docs/content/rust/how-to/env-variables.mdx b/apps/docs/content/rust/how-to/env-variables.mdx index b8748930..fbcca3fb 100644 --- a/apps/docs/content/rust/how-to/env-variables.mdx +++ b/apps/docs/content/rust/how-to/env-variables.mdx @@ -11,11 +11,32 @@ In Zerops you do not have to create a `.env` file manually. Zerops handles the e There are 3 different sets of env variables in Zerops: -| environment | type | defined in | -| ----------- | ------ | ------------------------------------------------------------------------------- | -| build | basic | [zerops.yml](/rust/how-to/build-pipeline#envvariables) | -| runtime | basic | [zerops.yml](/rust/how-to/build-pipeline#envvariables-1) | -| runtime | secret | [Zerops GUI](/rust/how-to/env-variables#set-secret-env-variables-in-zerops-gui) | + + + + + + + + + + + + + + + + + + + + + + + + + +
TypeEnvironmentDefined in
basicbuildzerops.yml
basicruntimezerops.yml
secretruntimeZerops GUI
Use the [secret env variables](/rust/how-to/create#set-secret-env-variables) for all sensitive data you don't want to store in your application code. Secret env variables are also useful if you need for testing where you need to change the value of some env variables frequently. Secret variables are managed in Zerops GUI and you don't have to redeploy your application. diff --git a/apps/docs/content/rust/how-to/scaling.mdx b/apps/docs/content/rust/how-to/scaling.mdx index a09da59d..6471a846 100644 --- a/apps/docs/content/rust/how-to/scaling.mdx +++ b/apps/docs/content/rust/how-to/scaling.mdx @@ -66,11 +66,33 @@ The CPU mode doesn't change automatically. Vertical auto scaling has following default configuration: -|   | Minimum resource | Maximum resource | -| ------------- | ---------------- | ---------------- | -| **CPU cores** | 1 | 5 | -| **RAM** | 0.25 GB | 32 GB | -| **Disk** | 1 GB | 100 GB | + + + + + + + + + + + + + + + + + + + + + + + + + +
Resources TypeMinimum resourceMaximum resource
CPU cores15
RAM0.25 GB32 GB
Disk1 GB100 GB
+ Rust service always starts with the minimal resources. diff --git a/apps/docs/src/components/GroupCards/index.tsx b/apps/docs/src/components/GroupCards/index.tsx new file mode 100644 index 00000000..02d4858a --- /dev/null +++ b/apps/docs/src/components/GroupCards/index.tsx @@ -0,0 +1,36 @@ +import React from "react"; + +interface CardItem { + name: string; + link: string; +} + +interface GroupCardsProps { + emoji?: string; + heading: string; + items: CardItem[]; +} + +const GroupCards: React.FC = ({ items, heading, emoji }) => { + return ( +

+
+ {emoji} + {heading} +
+
+ {items.map((item, index) => ( + + {item.name} + + ))} +
+
+ ); +}; + +export default GroupCards; \ No newline at end of file diff --git a/apps/docs/src/css/custom.css b/apps/docs/src/css/custom.css index bffd4bea..d4340b14 100644 --- a/apps/docs/src/css/custom.css +++ b/apps/docs/src/css/custom.css @@ -13,8 +13,8 @@ @layer components { .sidebar-title { - @apply !m-0 !py-1 !px-0; - @apply lg:first:top-0 lg:[&:not(:first-child)]:top-[20px]; + @apply !m-0 !py-0.5 mt-1 !px-1; + @apply lg:first:top-0 lg:[&:not(:first-child)]:top-[20px] bg-medusa-bg-subtle rounded-md; } .sidebar-title .menu__link { diff --git a/yarn.lock b/yarn.lock index 68c8c089..4adcebd4 100644 --- a/yarn.lock +++ b/yarn.lock @@ -6157,9 +6157,9 @@ cross-fetch@^3.1.6: node-fetch "^2.6.12" cross-spawn@^7.0.0, cross-spawn@^7.0.2, cross-spawn@^7.0.3: - version "7.0.3" - resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6" - integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w== + version "7.0.6" + resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.6.tgz#8a58fe78f00dcd70c370451759dfbfaf03e8ee9f" + integrity sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA== dependencies: path-key "^3.1.0" shebang-command "^2.0.0"