[DOCS-14173] Add "how to" regarding importing a Realm app which has Secrets Created: 01/Feb/21  Updated: 13/Dec/21  Resolved: 13/Dec/21

Status: Closed
Project: Documentation
Component/s: Realm
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Major - P3
Reporter: Mansoor Omar Assignee: Ben Perlmutter
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 2 years, 8 weeks, 2 days ago

 Description   

Description

Secret keys are not included when doing an Export.

When a customer attempts to Import the app, it will result in error: could not find secret

I found several Slack discussions on this topic and it seems the steps below is a workaround for this which should be added to a document or KB:

1) Export app
2) Import app via CLI (with ``could not find secret`` error)
3) Create the secret manually in the UI of the half-imported app ([or via CLI](https://docs.mongodb.com/realm/deploy/realm-cli-reference#create-a-secret))
4) Attempt import of app again via cli using ``realm-cli import --strategy=replace``

Articles that these steps may be added to:
https://docs.mongodb.com/realm/deploy/realm-cli-reference

It would also be good to mention that secrets cannot be exported/imported in this article:

https://docs.mongodb.com/realm/deploy/export-realm-app 

Slack conversation:

https://mongodb.slack.com/archives/C41SX3C4D/p1607108717012900

 

 

Scope of changes

Impact to Other Docs

MVP (Work and Date)

Resources (Scope or Design Docs, Invision, etc.)



 Comments   
Comment by Mansoor Omar [ 13/Dec/21 ]

Thanks ben.p looks good!

Comment by Ben Perlmutter [ 13/Dec/21 ]

merged & deployed 

Comment by Ben Perlmutter [ 01/Dec/21 ]

PR - https://github.com/mongodb/docs-realm/pull/1508 

Comment by Ben Perlmutter [ 30/Nov/21 ]

drafted changes. will do some manual validations tomorrow before putting up for review. 

Comment by Ben Perlmutter [ 30/Nov/21 ]

added slack convo from description to a google doc in case it's deleted from slack - https://docs.google.com/document/d/12B9LjHJ06eSPzdVH3dewuR1ddeJEIE1zmt2z_upfP7U/edit 

Comment by Chris Bush [ 16/Nov/21 ]

Update Importing an App page

Generated at Thu Feb 08 08:09:42 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.