Skip to content

Deploy your first container

Let's walk through together on your first deploying !

Prerequisites

  • Billing ready account
    You have your account set up with billing enabled.
    Don't have it yet ? You can achieve that here: Set up guide
  • Terraform/Open tofu installed
  • Basic understanding of Terraform/Open Tofu commands
  • Provider installed You have the provider installed.
    Don't have it yet ? You can find it here: Setup provider

Namespace

Before we start you will need a namespace, this is where your container will be living. 

1
2
3
4
resource "nexaa_namespace" "namespace" {
  name        = "namespace-name"
  description = "" # Description is optional
}

Container

Now we can deploy a container, a container is an application which runs in an encapsulated environment. You can specify the amount of resources needed for your container. This is a data source called nexaa_container_resources, where you can specify your cpu and memory. By default, the container has no persistent storage, so all the data which has been saved in your container will be gone after an update. 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
data "nexaa_container_resources" "container_resource" {
  cpu = 0.25
  memory = 0.5
}

resource "nexaa_container" "container" {
  depends_on = [
    nexaa_namespace.namespace
  ]
  name      = "container"
  namespace = nexaa_namespace.namespace.name
  image     = "nginx:latest"

  resources = data.nexaa_container_resources.container_resource.id

  ports = ["80:80"]

  ingresses = [
    {
      domain_name = "example.com" # domain_nane is optional if left empty we will provide one
      port        = 80
      tls         = true
      allow_list  = ["0.0.0.0/0"]
    }
  ]
}

Persistent storage

Like said before a container doesn't have persistent storage. If you want to store data, we can add a volume to a container on a specific path But first we need to deploy a volume. 

1
2
3
4
5
6
7
8
resource "nexaa_volume" "volume" {
  depends_on = [
    nexaa_namespace.namespace,
  ]
  namespace = nexaa_namespace.namespace
  name      = "volume"
  size      = 1 # the size of the volume can be 1 - 100, keep in mind the size can only grow not shrink.
}

After we have deployed our first volume we can mount it on a specific location in the container. 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
data "nexaa_container_resources" "container_resource" {
  cpu = 0.25
  memory = 0.5
}

resource "nexaa_container" "container" {
  depends_on = [
    nexaa_namespace.namespace,
    nexaa_volume.volume
  ]
  name      = "container"
  namespace = nexaa_namespace.namespace.name
  image     = "nginx:latest"

  resources = data.nexaa_container_resources.container_resource.id

  ports = ["80:80"]

  ingresses = [
    {
      domain_name = "example.com" # domain_nane is optional if left empty we will provide one
      port        = 80
      tls         = true
      allow_list  = ["0.0.0.0/0"]
    }
  ]

  mounts = [
    {
      path   = "/var/wwww/html"
      volume = nexaa_volume.volume.name
    }
  ]
}

Next Steps