Updated about 1 month ago
This page shows how to create and deploy Koyeb Stacks to upload, process, and store your data. Stacks are composed of three core components:
After you have deployed a Stack, you can start the upload and processing of your data using the Koyeb S3-compatible API endpoint.
There are four steps to deploy a new Stack:
On the Koyeb control panel navigation bar, click the "CREATE" button and select Stack.
You land on the Stack creation page.
Add a Workflow template
On the Create Stack page, in the create workflows section, click the "CREATE FROM TEMPLATE" button. Workflow templates are ready-to-use processing Workflow integrations implementing the most popular and requested processing pipelines to let you get started with ease. You can also compose your processing workflow from scratch.
The list of available Workflow templates appears showing for each template:
Let's select the "Image optimizer" template. This template store all uploaded images in the folder, optimize the source image by reducing the image size while maintaining the same visual quality, and store the result in the folder.
Once selected, the Workflow appears. You can click each step of the Workflow to change its settings. You can also add processing steps to the Workflow template.
Give the Stack a name
The Stack name is a unique name identifying your Stack and acts as the bucket name. It is used to interact with the Koyeb S3 API.
Configure the destination Store (Optional)
By default, Koyeb creates a Store for your Stack. In some cases, you need to use an existing Koyeb Store or connect a third-party cloud storage provider to act as your Stack Store.
To connect a Store, click the edit icon in the store section.
Select a Store integration
A drawer opens listing the integration available as a Store. In this documentation, I configure AWS S3 as a store for my Stack. The procedure for other Store integration is quite similar.
Configure the Store integration
To configure the Store, I need to define thename and to use to store the data processed by the Stack. Parameters may vary depending on the integration you select.
Deploy the Stack
We are now ready to deploy our Stack and start processing data. Click the "CREATE STACK" button to provision the freshly configured Stack.
You land on the Stack where are displayed various information about your Stack such as:
You can now start uploading and processing your files using the Koyeb S3-API. Check out the documentation to integrate the Koyeb S3-API with existing SDKs and CLI tools here.