-
Notifications
You must be signed in to change notification settings - Fork 25
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
AWS appsync migration guide #872
Conversation
✅ Deploy Preview for docs-app-services ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
small nits for you to take or leave; otherwise, LGTM 🚀
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure if it's intentional while you're working on these guides, but this page is only accessible through the URL -- it isn't accessible through the Device Sync Deprecation
option in the left nav menu
source/sync/migration/awsappsync.txt
Outdated
- Device Sync APIs send changes to Atlas App Services. | ||
- Atlas App Services performs any necessary conflict resolution, stores the changes | ||
in Atlas, and syncs the changes to the other devices. | ||
- Device Sync APIs updates the data in each device’s local realm. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Device Sync APIs updates the data in each device’s local realm. | |
- Device Sync APIs update the data in each device’s local realm. |
source/sync/migration/awsappsync.txt
Outdated
.. image:: /images/migration/device_sync_architecture.png | ||
:alt: A diagram showing a typical Device Sync architecture. | ||
|
||
In this architecture, your app uses the Realm APIs to communicate directly with |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should this be uses the Atlas Device Sync APIs
?
source/sync/migration/awsappsync.txt
Outdated
- Use AWS Event Bridge to listen for event triggers from Atlas | ||
- Add a Database Trigger to Atlas | ||
|
||
You will also change 2 parts of your client code: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You will also change 2 parts of your client code: | |
You will also need to change the following in your client code: |
source/sync/migration/awsappsync.txt
Outdated
- The local data store also changes from a Realm database to the default | ||
datastore on the device (typically SQLite), or another one of your choice. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- The local data store also changes from a Realm database to the default | |
datastore on the device (typically SQLite), or another one of your choice. | |
- Change the local datastore from a Realm database to the default | |
datastore on the device (typically SQLite) or another of your choice. |
source/sync/migration/awsappsync.txt
Outdated
- Because AppSync uses GraphQL, you will use the AWS AppSync API to communicate | ||
with it AppSync |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Because AppSync uses GraphQL, you will use the AWS AppSync API to communicate | |
with it AppSync | |
- Because AppSync uses GraphQL, you need to use AWS AppSync APIs to access GraphQL endpoints from your application. |
.. image:: /images/migration/aws_appsync_architecture.png | ||
:alt: A diagram showing a typical Device Sync architecture. | ||
|
||
Migration Steps |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If these are truly "steps" (which they seem to be), can we change the bullets to numbered items?
:titlesonly: | ||
:hidden: | ||
|
||
Migrate to AWS AppSync </sync/migration/awsappsync> | ||
|
||
As of September 2024, Device Sync is deprecated for Atlas App Services. Device | ||
Sync will reach end-of-life and be removed on **September 30, 2025**. If you |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can't suggest changes to the below line, but maybe update to specify ...you should migrate to one of the alternative solution providers listed below...
?
Pull Request Info
Jira ticket: https://jira.mongodb.org/browse/DOCSP-NNNNN
Staging Links
Reminder Checklist
Before merging your PR, make sure to check a few things.
Release Notes
Review Guidelines
REVIEWING.md