Skip to content

Commit 8de374e

Browse files
authored
fix(mnq): add back FIFO topics and SQS subscriptions (#3765)
* fix(mnq): added fifo topic type back * fix(mnq): add back FIFO and SQS subsc
1 parent 8080918 commit 8de374e

File tree

7 files changed

+24
-12
lines changed

7 files changed

+24
-12
lines changed

faq/messaging-and-queuing.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ content:
66
h1: Messaging and Queuing
77
hero: assets/messaging.webp
88
dates:
9-
validation: 2024-09-25
9+
validation: 2024-09-26
1010
category: serverless
1111
---
1212

@@ -23,6 +23,7 @@ We currently implement the API endpoints listed [here](/serverless/messaging/ref
2323
The following subscriber types are supported:
2424
- HTTP/S clients
2525
- Serverless Functions and Containers
26+
- Scaleway Messaging and Queuing SQS queues
2627

2728
For more details on supported and unsupported SNS features, see our [dedicated page](/serverless/messaging/reference-content/sns-support/).
2829

-19.8 KB
Binary file not shown.

serverless/messaging/concepts.mdx

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -163,18 +163,15 @@ A subscription protocol refers to the communication method used to deliver messa
163163
| HTTP | The URL of a service or web server that can receive notifications (HTTP POST requests) from SNS, e.g. `http://example.fr` | - For security reasons, we recommend using the HTTPS protocol rather than HTTP. <br /> - HTTP subscriptions must be [confirmed](/serverless/messaging/how-to/create-manage-subscriptions/#how-to-confirm-an-http-or-https-subscription) after creation |
164164
| HTTPS | The URL of a service or web server that can receive notifications (HTTPS POST requests) from SNS, e.g. `https://example.fr` | - HTTPS subscriptions must be [confirmed](/serverless/messaging/how-to/create-manage-subscriptions/#how-to-confirm-an-http-or-https-subscription) after creation |
165165
| Serverless Functions and Containers | A Scaleway Serverless [Function](/serverless/functions/quickstart/) or [Container](/serverless/containers/quickstart/) <br /> | - It must have a [public](/serverless/functions/concepts/#privacy-policy) privacy policy <br /> - It must be in a [namespace](/serverless/functions/concepts/#namespace) from the same [Project](/identity-and-access-management/organizations-and-projects/concepts/#project) and [region](#region) as the SNS topic |
166+
| SQS | A Scaleway Messaging and Queueing SQS [Queue](#queue) <br /> | - It must be in the same [Project](/identity-and-access-management/organizations-and-projects/concepts/#project) and [region](#region) as the SNS topic |
166167

167168
## Topic
168169

169170
A topic is a communication channel used to send messages and notifications to subscribed endpoints or clients. Publishers send messages to topics, and those messages are received by subscribers. Subscribers can include Serverless Functions and HTTP/HTTPS endpoints. As such, topics decouple the publishing and the receiving of messages, allowing for flexibility and scalabilty in building loosely-coupled systems.
170171

171172
## Topic types
172173

173-
When creating topics with Scaleway Messaging and Queuing SQS or SNS, only one topic type is currently available: [Standard](#standard). Standard topics provide at-least-once delivery. Find out more about creating topics with our [dedicated documentation](/serverless/messaging/how-to/create-manage-topics/).
174-
175-
<Message type="note">
176-
It is planned to also offer the [FIFO](#fifo) topic type in the future, for first-in-first-out delivery, guaranteeing that messages are delivered in order and without duplication. Join the **#messaging-queuing** channel on the [Scaleway Slack Community](https://slack.scaleway.com/) for updates and information on new features and releases.
177-
</Message>
174+
When creating topics with Scaleway Messaging and Queuing SQS or SNS, two topic types are available. [Standard](#standard) topics provide at-least-once delivery, while [FIFO](#fifo) topics offer first-in-first-out delivery, and (unlike Standard topics) guarantee that messages are delivered in order and without duplication. [Content-based deduplication](#content-based-deduplication) is only available for FIFO topic types. Find out more about creating topics with our [dedicated documentation](/serverless/messaging/how-to/create-manage-topics/).
178175

179176
## Topic-based
180177

-19.8 KB
Binary file not shown.

serverless/messaging/how-to/create-manage-subscriptions.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ tags: messaging queuing subscriptions sns topics
99
categories:
1010
- serverless
1111
dates:
12-
validation: 2024-08-23
12+
validation: 2024-09-26
1313
posted: 2024-02-06
1414
---
1515

@@ -65,6 +65,12 @@ This page shows how to create and manage SNS [subscriptions](/serverless/messagi
6565

6666
You are prompted to select the Serverless Function or Container to subscribe. Only Functions and Containers with a public [privacy policy](/serverless/functions/concepts/#privacy-policy) can subscribe to an SNS topic.
6767
</TabsTab>
68+
<TabsTab label="SQS">
69+
<br />
70+
Choose **SQS** to create a subscription for a Scaleway SQS queue that you have created.
71+
72+
You are prompted to select the **queue** to subscribe. Only queues in the same [Project](/identity-and-access-management/organizations-and-projects/concepts/#project) and [region](/serverless/messaging/concepts/#region) as the SNS topic can be selected.
73+
</TabsTab>
6874
</Tabs>
6975

7076
7. Click **Create subscription** to finish.

serverless/messaging/how-to/create-manage-topics.mdx

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ tags: messaging queuing topics sns
99
categories:
1010
- serverless
1111
dates:
12-
validation: 2024-08-23
12+
validation: 2024-09-26
1313
posted: 2023-12-27
1414
---
1515

@@ -28,11 +28,12 @@ This page shows how to create and manage SNS [topics](/serverless/messaging/conc
2828
2. Use the drop-down menu to select the [region](/serverless/messaging/concepts/#region) in which you want to create a topic.
2929

3030
3. Click **SNS**, then navigate to the **Topics** tab and click **Create topic**. The topic creation wizard displays.
31-
<Lightbox src="scaleway-create-topic.webp" alt="" />
3231

3332
4. Enter a **name** for your topic. The name must contain no more than 80 characters, and consist only of alphanumeric characters, hyphens, and underscores. Alternatively, you can go with the auto-generated name suggested for you.
3433

35-
5. Choose a **topic type**. Currently, only the **Standard** topic type is available, ensuring at-least-once delivery. See the [topic types](/serverless/messaging/concepts/#topic-types) documentation for more information.
34+
5. Choose a **topic type**. The following topic types are available:
35+
- **Standard**: Ensures at-least-once message delivery, where the order of messages is not preserved. Supports Serverless Functions, Serverless Containers and HTTP/S subscriptions.
36+
- **FIFO**: Provides first-in-first-out delivery, where the order of messages is preserved without duplication. Supports SQS subscriptions. [Content-based deduplication](/serverless/messaging/concepts/#content-based-deduplication) is only available for FIFO topics.
3637

3738
6. Click **Create topic** to finish.
3839

serverless/messaging/quickstart.mdx

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -180,11 +180,12 @@ Credentials for SNS are granular: you can define the level of access that they s
180180
2. Use the drop-down menu to select the [region](/serverless/messaging/concepts/#region) in which you want to create a topic.
181181

182182
3. Click **SNS**, then navigate to the **Topics** tab and click **Create topic**. The topic creation wizard displays.
183-
<Lightbox src="scaleway-create-topic.webp" alt="" />
184183

185184
4. Enter a **name** for your topic. The name must contain no more than 80 characters, and consist only of alphanumeric characters, hyphens, and underscores. Alternatively, you can go with the auto-generated name suggested for you.
186185

187-
5. Choose a **topic type**. Currently, only the **Standard** topic type is available, ensuring at-least-once delivery. See the [topic types](/serverless/messaging/concepts/#topic-types) documentation for more information.
186+
5. Choose a **topic type**. The following topic types are available:
187+
- **Standard**: Ensures at-least-once message delivery, where the order of messages is not preserved. Supports Serverless Functions, Serverless Containers and HTTP/S subscriptions.
188+
- **FIFO**: Provides first-in-first-out delivery, where the order of messages is preserved without duplication. Supports SQS subscriptions. [Content-based deduplication](/serverless/messaging/concepts/#content-based-deduplication) is only available for FIFO topics.
188189

189190
6. Click **Create topic** to finish.
190191

@@ -234,6 +235,12 @@ You are returned to the **Topics** tab, where your newly-created topic now displ
234235

235236
You are prompted to select the Serverless Function or Container to subscribe. Only Functions and Containers with a public [privacy policy](/serverless/functions/concepts/#privacy-policy) can subscribe to an SNS topic.
236237
</TabsTab>
238+
<TabsTab label="SQS">
239+
<br />
240+
Choose **SQS** to create a subscription for a Scaleway SQS queue that you have created.
241+
242+
You are prompted to select the **queue** to subscribe. Only queues in the same [Project](/identity-and-access-management/organizations-and-projects/concepts/#project) and [region](/serverless/messaging/concepts/#region) as the SNS topic can be selected.
243+
</TabsTab>
237244
</Tabs>
238245

239246
7. Click **Create subscription** to finish.

0 commit comments

Comments
 (0)