Skip to content

NOISSUE - Add getting started with Atom blog#159

Open
ianmuchyri wants to merge 10 commits into
mainfrom
atom-tutorial
Open

NOISSUE - Add getting started with Atom blog#159
ianmuchyri wants to merge 10 commits into
mainfrom
atom-tutorial

Conversation

@ianmuchyri

Copy link
Copy Markdown
Contributor

What type of PR is this?

What does this do?

Which issue(s) does this PR fix/relate to?

Have you included tests for your changes?

Did you document any new/modified features?

Notes

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 12, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
absmach-website 0aee348 Commit Preview URL

Branch Preview URL
Jun 17 2026, 02:53 PM

Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>

@dborovcanin dborovcanin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are missing instruction on ADMIN_SECRET - so if I blindly follow commands, I get:

❯ docker compose up postgres -d
docker compose --profile atom-ui up -d --build
error while interpolating services.atom.environment.ADMIN_SECRET: required variable ADMIN_SECRET is missing a value: set ADMIN_SECRET
error while interpolating services.atom.environment.ADMIN_SECRET: required variable ADMIN_SECRET is missing a value: set ADMIN_SECRET

This architecture block should have a separate section or be a part of the intro.
Image

Replace all dark-theme screenshots with light-theme versions and
rename them by dropping the -light suffix. Remove old screenshots
from the previous tutorial iteration. Replace em dashes throughout
the prose with colons, semicolons, parentheses, or sentence breaks.
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>

@dborovcanin dborovcanin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Screenshots are still too small in UI:

Image

Comment thread src/content/blogs/getting-started-with-atom.md Outdated
Comment thread src/content/blogs/getting-started-with-atom.md Outdated
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>
Signed-off-by: ianmuchyri <ianmuchiri8@gmail.com>

4. **Postgres connection refused on startup.** The database container needs a moment to fully initialize before accepting connections. If you see this, wait 15–20 seconds after starting and then check again.

5. **Authorization check returns `"unknown action 'read'"`.** In Atom v0.1.0, the `read` action is only registered for built-in resource kinds (`channel`, `rule`, `report`, `alarm`). Use `kind: "channel"` for your test resource, or add the appropriate row to `action_applicability` if you're working with a custom kind.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This look a lot like Magistrala-specific setup. Atom should not come with these out of box, but it should be provisioned on bootstrapping.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants