Skip to content

Commit 1d5f59d

Browse files
josefaidtjosefaidt
committed
add note for custom pipelines
1 parent 95a57c1 commit 1d5f59d

File tree

1 file changed

+62
-42
lines changed
  • src/pages/[platform]/start/migrate-to-gen2

1 file changed

+62
-42
lines changed

‎src/pages/[platform]/start/migrate-to-gen2/index.mdx

Lines changed: 62 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,19 @@ export function getStaticProps(context) {
3131

3232
Amplify migration tooling is available! In this guide we will walk through how to perform migrations for your backends from Amplify Gen 1 to Amplify Gen 2. The steps you will perform will be against a new Amplify Gen 1 backend environment, and a new Amplify Gen 2 environment. After the steps are performed, you will be able to merge the migration branch onto your existing branches to individually migrate with zero downtime.
3333

34+
The migration tooling supports all major categories of Amplify Gen 2:
35+
36+
- Auth
37+
- Data (previously API > GraphQL API)
38+
- Storage
39+
- Functions
40+
41+
Please note not all resource configuration properties are supported, however the migration tooling will generate code with errors signaling where manual intervention is required.
42+
43+
{/* ## Feature Support Matrix */}
44+
45+
{/* big table of features */}
46+
3447
## Preparing for migration
3548

3649
The most notable change between Amplify Gen 1 backends and Gen 2 backends is the use of infrastructure as code with TypeScript. Preparing your environment for migration involves converting the configuration of your live Gen 1 backend resources to their Gen 2 equivalent written using TypeScript.
@@ -77,12 +90,16 @@ After this command completes successfully your `amplify/` directory is converted
7790

7891
## Validating the preparation
7992

80-
{/* how to handle the thrown errors in the code */}
93+
The preparation command will add npm dependencies relevant to your Gen 2 backend in the root `package.json`. Before you begin with the validation, install dependencies:
8194

8295
```bash title="Terminal" showLineNumbers={false}
8396
npm install
8497
```
8598

99+
{/* how to handle the thrown errors in the code */}
100+
{/* porting custom resolvers, overridden resolvers */}
101+
{/* porting custom resources themselves */}
102+
86103
```bash title="Terminal" showLineNumbers={false}
87104
npx ampx sandbox
88105
```
@@ -122,6 +139,8 @@ npx @aws-amplify/migrate@latest to-gen-2 execute \
122139

123140
{/* a note about s3 bucket names */}
124141
{/* ... anything else */}
142+
{/* set up CI/CD */}
143+
{/* deploy using backend-cli manually (for those not using Amplify to deploy today) */}
125144

126145
## Verify continuous deployment
127146

@@ -141,47 +160,48 @@ The tables below present a feature matrix for Gen 1 customers who are considerin
141160

142161
### Auth
143162

144-
| Feature | Gen 1 | Gen 2 |
145-
|---|---|---|
146-
| Configure username | Yes | Yes with CDK |
147-
| Configure email | Yes | Yes |
148-
| Configure phone number | Yes | Yes |
149-
| Facebook | Yes | Yes |
150-
| Google | Yes | Yes |
151-
| Amazon | Yes | Yes |
152-
| Sign-in with Apple | Yes | Yes |
153-
| Add user pool groups | Yes | Yes |
154-
| User pool group preference | Yes | Yes |
155-
| Email verification link redirect | Yes | Yes |
156-
| Sign-up attributes | Yes | Yes |
157-
| Auth trigger support | Yes | Yes |
158-
| Auth trigger templates: Add Google reCaptcha Challenge | Yes | Yes |
159-
| Auth trigger templates: Add user to Group | Yes | Yes |
160-
| Auth trigger templates: Email Domain Filtering (denylist) | Yes | Yes |
161-
| Auth trigger templates: Email Domain Filtering (allowlist) | Yes | Yes |
162-
| Auth trigger templates: Override ID Token Claims | Yes | Yes |
163-
| Auth trigger templates: Custom Auth Challenge Flow| Yes | No |
164-
| Configure default password policy | Yes | Yes with CDK |
165-
| Configure read/write capabilities for attributes | Yes | Yes with CDK |
166-
| Oauth flow: Configure authorization v implicit grant | Yes | Yes with CDK |
167-
| Admin queries | Yes | Yes with CDK |
168-
| MFA login (on/off/optional) | Yes | Yes |
169-
| MFA: SMS | Yes | Yes |
170-
| MFA: TOTP | Yes | Yes |
171-
| Zero-config Authenticator support | Yes | Yes |
172-
| User management in console | Yes | Yes |
173-
| Configure Oauth scopes | Yes | Yes |
174-
| Email verification - code | Yes | Yes |
175-
| Email Verification - Link | Yes | Yes |
176-
| Oauth flow: Configure redirect URIs | Yes | Yes |
177-
| Ability to set a friendly name for User Pool | Yes | Yes |
178-
| Unauthenticated logins | Yes | Yes |
179-
| Custom attributes | Yes | Yes with CDK |
180-
| Oauth flow: Configure domain name prefix | Yes | Yes with CDK |
181-
| Auth configuration in console | Yes | No |
182-
| First class OIDC support | No | Yes |
183-
| First class SAML support | No | Yes |
184-
| Import auth | Yes | No |
163+
| Feature | Gen 1 | Gen 2 |
164+
| ---------------------------------------------------------- | ----- | ------------ |
165+
| Configure username | Yes| Yes with CDK |
166+
| Configure email | Yes | Yes |
167+
| Configure phone number | Yes | Yes |
168+
| Facebook | Yes | Yes |
169+
| Google | Yes | Yes |
170+
| Amazon | Yes | Yes |
171+
| Sign-in with Apple | Yes | Yes |
172+
| Add user pool groups | Yes | Yes |
173+
| User pool group preference | Yes | Yes |
174+
| Email verification link redirect | Yes | Yes |
175+
| Sign-up attributes | Yes | Yes |
176+
| Auth trigger support | Yes | Yes |
177+
| Auth trigger templates: Add Google reCaptcha Challenge | Yes | Yes |
178+
| Auth trigger templates: Add user to Group | Yes | Yes |
179+
| Auth trigger templates: Email Domain Filtering (denylist) | Yes | Yes |
180+
| Auth trigger templates: Email Domain Filtering (allowlist) | Yes | Yes |
181+
| Auth trigger templates: Override ID Token Claims | Yes | Yes |
182+
| Auth trigger templates: Custom Auth Challenge Flow | Yes | No |
183+
| Configure default password policy | Yes | Yes with CDK |
184+
| Configure read/write capabilities for attributes | Yes | Yes with CDK |
185+
| Oauth flow: Configure authorization v implicit grant | Yes | Yes with CDK |
186+
| Admin queries | Yes | Yes with CDK |
187+
| MFA login (on/off/optional) | Yes | Yes |
188+
| MFA: SMS | Yes | Yes |
189+
| MFA: TOTP | Yes | Yes |
190+
| Zero-config Authenticator support | Yes | Yes |
191+
| User management in console | Yes | Yes |
192+
| Configure Oauth scopes | Yes | Yes |
193+
| Email verification - code | Yes | Yes |
194+
| Email Verification - Link | Yes | Yes |
195+
| Oauth flow: Configure redirect URIs | Yes | Yes |
196+
| Ability to set a friendly name for User Pool | Yes | Yes |
197+
| Unauthenticated logins | Yes | Yes |
198+
| Custom attributes | Yes | Yes with CDK |
199+
| Oauth flow: Configure domain name prefix | Yes | Yes with CDK |
200+
| Auth configuration in console | Yes | No |
201+
| First class OIDC support | No | Yes |
202+
| First class SAML support | No | Yes |
203+
| Import auth | Yes | No |
204+
185205

186206
### Data
187207

0 commit comments

Comments
 (0)