PermalinkMigrating the Developer Portal to the Latest Version
PermalinkMigrating the Developer Portal from 1.5 to 2.1
Developer Portal migrations are required to upgrade from Kong Gateway 1.5 to Kong Gateway 2.1. You can make these changes with the Kong templates repository using either the Kong Portal CLI, or directly in the Kong Developer Portal Editor UI. Using the CLI to take advantage of source control is recommended.
PermalinkLinks to templates and CLI
PermalinkCreate files
The following files must be created for the 2.1 Kong Developer Portal to function properly. Create each file using the name, path, and contents linked below:
-
Permalinkworkspaces/default/themes/base/assets/js/app-44b7b4e.min.js
- Templates Path:
/workspaces/default/themes/base/assets/js/app-44b7b4e.min.js
- File Content on GitHub: /default/themes/base/assets/js/app-44b7b4e.min.js
- Templates Path:
-
Permalinkworkspaces/default/themes/base/layouts/system/markdown.html
- Templates Path:
/workspaces/default/themes/base/layouts/system/markdown.html
- File Content on GitHub: /workspaces/default/themes/base/layouts/system/markdown.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/assets/styles/markdown-fixes.css
- Templates Path:
/workspaces/default/themes/base/assets/styles/markdown-fixes.css
- File Content on GitHub: /workspaces/default/themes/base/assets/styles/markdown-fixes.css
- Templates Path:
-
Permalinkworkspaces/default/themes/base/assets/styles/markdown.css
- Templates Path:
/workspaces/default/themes/base/assets/styles/markdown.css
- File Content on GitHub: /workspaces/default/themes/base/assets/styles/markdown.css
- Templates Path:
PermalinkReplace content in existing files
Update the following files that already exist in your Dev Portal workspaces for 1.5.x. Replace the existing contents of the files with the 2.1.x content linked below.
-
Permalinkworkspaces/default/content/applications/view.txt
- Templates Path:
/workspaces/default/content/applications/view.txt
- File Content GitHub: /workspaces/default/content/applications/view.txt
- Templates Path:
-
Permalinkworkspaces/default/themes/base/layouts/_app.html
- Templates Path:
/workspaces/default/themes/base/layouts/_app.html
- File Content: /workspaces/default/themes/base/layouts/_app.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/layouts/system/create-app.html
- Templates Path:
/workspaces/default/themes/base/layouts/system/create-app.html
- File Content GitHub: /workspaces/default/themes/base/layouts/_app.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/layouts/system/edit-app.html
- Templates Path:
/workspaces/default/themes/base/layouts/system/edit-app.html
- File Content GitHub: /workspaces/default/themes/base/layouts/system/edit-app.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/layouts/system/view-app.html
- Templates Path:
/workspaces/default/themes/base/layouts/system/view-app.html
- File Content GitHub: /workspaces/default/themes/base/layouts/system/view-app.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/partials/footer.html
- Templates Path:
/workspaces/default/themes/base/partials/footer.html
- File Content GitHub: /workspaces/default/themes/base/partials/footer.html
- Templates Path:
-
Permalinkworkspaces/default/themes/base/partials/theme/required-scripts.html
- Templates Path:
/workspaces/default/themes/base/partials/theme/required-scripts.html
- File Content GitHub: /workspaces/default/themes/base/partials/theme/required-scripts.html
- Templates Path:
PermalinkDelete obsolete files
You can remove the following files from your Developer Portal.
-
Permalinkdashboard-6ae0d66.min.js
- Templates Path:
workspaces/default/themes/base/assets/js/dashboard-6616db8.min.js
- Templates Path:
PermalinkDeclare application version
To make future migrations easier, an app_version
declaration has been
added in portal.conf.yaml
as shown below. Add the app_version
to your
current portal configuration files. You can view the complete portal.conf.yaml
file on
GitHub.
...
app_version: 44b7b4e
...
PermalinkSee also
For information about upgrading Kong Gateway, see Migrating from 1.5.x to 2.1.x.