queue

A queue for work handed from one part of an application to another: one side publishes, another consumes, and a message survives until it is handled.

ackee 1
​
project "shop" {
  cloud      = "gcp"
  region     = "us-east1"
  gcpProject = "acme-shop"
}
​
service "api" {
  image  = "us-docker.pkg.dev/cloudrun/container/hello"
  public = true
}
​
worker "fulfilment" {
  image = "us-docker.pkg.dev/cloudrun/container/hello"
}
​
queue "orders" {}
​
connect env "api" -> "orders"
connect iam "api" -> "orders"
connect env "fulfilment" -> "orders"
connect iam "fulfilment" -> "orders"

Fields

None. The name is all that means the same thing on every cloud; write queue "name" {}.

Any other field is refused (AK204), and the error names the exact type to declare with node for the setting you wanted.

What it becomes

Joins the shared network net: Azure only.

What a connection hands over

An env connection to a queue gives the consumer these variables, each prefixed by the queue's name in upper case — queue "orders" gives ORDERS_…:

Notes

• Publishing and consuming need connect iam from each side to the queue as well as env.
• Retention, delivery attempts and ordering differ between clouds and are not portable: declare the queue with node to set them.