Yelken Docs

Appearance

Create a Service From a Container Image ​

Yelken allows you to run a container image from a public or private container registry (e.g. Docker Hub). To let Yelken access your private images, you can define the credentials of your private registry. Additionally, you can pass information in runtime or have a persistent volume by defining variables and mounting volumes into your service.

In this guide, we will create a new project from scratch. If you already have a project and want to have a service in that project, you can use Create Service button too. Whether you create a project from scratch or add a new service to an existing project, the steps are same.

To start creating a new project and a service from a container image:

  1. Go to Create Project page. You can also access it in the Projects page by using Create Project button.

  2. Choose Container Image item from the options.

  3. In this step, you can configure various parts of your service.

    3.1. Specify the URL of your container image.

    For images located inside Docker Hub, you can specify just the repository of your image with tag such as nginx:stable. For images stored outside of Docker Hub, you need to specify the full URL such as registry.example.com/nginx:stable.

    3.2. Optionally, to pass information in runtime or have a persistent volume, you can add variables and mount volumes to your service.

  4. Choose an appropriate plan for your service.

  5. Lastly, give a name to your project and use Create button to start creating the project and service.

Container image compatibility

Currently, Yelken only supports OCI container images that are compatible with x86_64 architecture. It is planned for the future to expand this compatiblity to images with arm64 architecture.

Images stored in private registries.

If you want to use an image stored inside an internet accessible private registry, you need to add a Container Registry under Project's Settings with correct credentials to let Yelken access your private registry during container startup.

After adding Container Registry, you can choose it to use for the image while creating the service.

Your credentials are securely stored in Yelken infrastructure by encrypting them at rest.

After creating the project and service successfully, you will be navigated to Services page where you can see the status of your newly created service. You can view details of your service by using View Service button. Additionally, you can track the state of deployments inside the service's details page.

Initially, your service will be in Creating and then in Initializing state. These states mean that Yelken is creating necessary resources for service to start running. Depending on the image size and available resources on Yelken, it can take one or two minutes for service to switch to Running state. If an error occurs during container startup, such as image pull failures or application crashes, state of service will show an error.