strapi/docs/3.0.0-beta.x/migration-guide/migration-guide-beta.18-to-beta.19.md
Pierre Noël 57d7d876b7
Fix/#4513/ability to use a sub path behind a proxy (#5833)
* add possibility to use strapi on a non-root base url path

* fix documentation password form

* use server.url and admin.url in config

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* update doc proxy

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* move server.url location in config

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* refacto

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* add possibility to put relative urls

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* allow '/' as an admin url + refacto

Signed-off-by: Pierre Noël <pierre.noel@strapi.io>

* update yarn.lock

Signed-off-by: Pierre Noël <petersg83@gmail.com>

* refacto

Signed-off-by: Pierre Noël <petersg83@gmail.com>

* Remove default proxy option

Signed-off-by: Alexandre Bodin <bodin.alex@gmail.com>

* fix github provider

Signed-off-by: Pierre Noël <petersg83@gmail.com>

* fix github login

Signed-off-by: Pierre Noël <petersg83@gmail.com>

* Remove files that should be here

Signed-off-by: Alexandre Bodin <bodin.alex@gmail.com>

Co-authored-by: Pierre Noël <pierre.noel@strapi.io>
Co-authored-by: Alexandre Bodin <bodin.alex@gmail.com>
2020-05-08 13:50:00 +02:00

2.2 KiB

Migration guide from beta.18.x to beta.19

Upgrading your Strapi application to v3.0.0-beta.19.

Make sure your server is not running until the end of the migration

Upgrading your dependencies

Start by upgrading your dependencies. Make sure to use exact versions.

Update your package.json accordingly:

{
  //...
  "dependencies": {
    "strapi": "3.0.0-beta.19",
    "strapi-admin": "3.0.0-beta.19",
    "strapi-connector-bookshelf": "3.0.0-beta.19",
    "strapi-plugin-content-manager": "3.0.0-beta.19",
    "strapi-plugin-content-type-builder": "3.0.0-beta.19",
    "strapi-plugin-email": "3.0.0-beta.19",
    "strapi-plugin-graphql": "3.0.0-beta.19",
    "strapi-plugin-upload": "3.0.0-beta.19",
    "strapi-plugin-users-permissions": "3.0.0-beta.19",
    "strapi-utils": "3.0.0-beta.19"
  }
}

Then run either yarn install or npm install.

Policies syntax change

We decided to change the policies naming convention to match the future naming convention we will be using throughout the project.

Before

  • Global policy: global.{policy}.
  • Plugin policy: plugins.{pluginName}.{policy}.

After

  • Global policy: global::{policy}.
  • Plugin policy: plugins::{pluginName}.{policy}.

We are also introducing application naming so you can access an api policy more easily or reference it absolutely when the context otherwise wouldn't allow to find it directly.

You can now reference a policy located at ./api/{apiName}/config/policies/{policy} with the following syntax: {apiName}.{policy}.

Although we do not recommend it (as it is error prone), you can still access a given local policy with the syntax {policy}. This syntax will only allow access to a policy declared in the scope of the api you are referencing it from (e.g, a given policy within the restaurant api and a route within the restaurant api only).

Rebuilding your administration panel

Now delete the .cache and build folders. Then run yarn develop.

::: warning NOTE

If you have modified the admin/src/config.js file you need to update its content with:

export const LOGIN_LOGO = null;
export const SHOW_TUTORIALS = false;
export const SETTINGS_BASE_URL = '/settings';

:::