Skip to content
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

Update upgrade_from_50_to_60.rst #1790

Open
wants to merge 53 commits into
base: 6.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
53 commits
Select commit Hold shift + click to select a range
cdd33d2
PIM-10202: Fix the limit of options in a reference entity attribute (…
nmarniesse Dec 14, 2021
4b1b980
Fix documentation with upgrade to Sphinx 4.4 (#1721)
jmleroux Feb 7, 2022
4ef5bdd
Merge branch 6.0 into master
jmleroux Feb 8, 2022
09830a8
BH-986: Merge 6.0 into master (#1726) from akeneo/BH-986-pullup
jmleroux Feb 8, 2022
337e129
update technical recommendation
pyklein Feb 18, 2022
b14a26a
Update recommended_configuration.rst
pyklein Feb 18, 2022
aac3417
Merge 6.0 into master
micheltag Feb 21, 2022
dcc9975
No automatic pullup for master
jmleroux Feb 21, 2022
ef847e5
Fix malformed table
jmleroux Feb 21, 2022
aad2ab1
Merge 6.0 into master (#1734)
jmleroux Feb 21, 2022
88afa97
Merge 6.0 into master
micheltag Feb 21, 2022
979628b
PullUp: Fix master branch references
jmleroux Feb 21, 2022
5a716bf
Merge 6.0 into master (#1736)
jmleroux Feb 21, 2022
804bdbc
Merge 6.0 into master
micheltag Feb 24, 2022
f1b73fd
Merge pull request #1739 from akeneo/60_to_master_20220224160439
PierrickMartos Feb 24, 2022
a40dd2a
Merge 6.0 into master
micheltag Mar 2, 2022
8f46ba3
Merge pull request #1743 from akeneo/60_to_master_20220302155512
ahocquard Mar 2, 2022
0d6d1f7
Merge 6.0 into master
micheltag Mar 2, 2022
e33d4f2
Merge pull request #1745 from akeneo/60_to_master_20220302164143
ahocquard Mar 2, 2022
eb78861
Update the docker install command with new composer cache directory
PierrickMartos Mar 3, 2022
71ebf10
Merge pull request #1746 from akeneo/update-pim-docker-installation
PierrickMartos Mar 4, 2022
c9c792c
Merge 6.0 into master
micheltag Mar 4, 2022
3d6b4a5
Pull up 6.0 to master (#1748)
jmleroux Mar 4, 2022
68aff33
marketplace renaming
meganelepalud-akeneo Mar 4, 2022
5ffe03f
BH-1113: Update migration doc for v6 - Add all migrations before stac…
jmleroux Mar 7, 2022
9111da7
Merge branch 6.0 into master
jmleroux Mar 7, 2022
f82c42e
Merge branch 6.0 into master (#1752)
jmleroux Mar 7, 2022
2fd73a2
Merge pull request #1749 from meganelepalud-akeneo/marketplace-renaming
tseho Mar 10, 2022
a3505a8
Merge 6.0 into master
micheltag Mar 14, 2022
c1ce06c
Merge pull request #1757 from akeneo/60_to_master_20220314093228
PierrickMartos Mar 14, 2022
68c4304
Merge branch '6.0' into pullup-v6
jmleroux Mar 15, 2022
b49d541
Merge branch 6.0 into master (#1761)
jmleroux Mar 15, 2022
ee481cb
Merge 6.0 into master
micheltag Mar 15, 2022
8abe2ce
PIM:10344: Add dqi command to launch in 5.0 to 6.0 migration
BryanS29-akeneo Mar 17, 2022
8c1c635
API-1741 - Update PIM doc according events API installation to migrat…
benjaminleneve Mar 17, 2022
9485a92
Merge 6.0 into master
micheltag Mar 17, 2022
61ec680
Pull up 6.0 to master (#1766)
jmleroux Mar 17, 2022
fd244a7
PIM:10344: Add dqi command to launch in 5.0 to 6.0 migration
BryanS29-akeneo Mar 17, 2022
2a53413
Merge pull request #1767 from akeneo/API-1741-update-pim-doc-migratio…
benjaminleneve Mar 17, 2022
ef62c76
Merge pull request #1765 from akeneo/PIM-10344
BryanS29-akeneo Mar 17, 2022
c189b97
CLOUD-3051: Add Flexibility updates (#1771)
LudovicTOURMAN Mar 28, 2022
91041d9
PLG-779: initiate doc to migrate from 6.0 to 7.0
LaurentPetard Mar 30, 2022
6bed20d
Merge pull request #1772 from akeneo/PLG-779
LaurentPetard Mar 31, 2022
69a9356
Merge pull request #1763 from akeneo/60_to_master_20220315163302
jmleroux Apr 5, 2022
639fdd6
PLG-469: Add dqi command to launch before doctrine migrations
BryanS29-akeneo Apr 8, 2022
570ef96
Pull up 6.0 to master (#1777)
micheltag Apr 14, 2022
8b14a96
Merge pull request #1775 from akeneo/PLG-469
BryanS29-akeneo Apr 22, 2022
90d4b2e
Hotfix: Fix external link for CurrencyDisablingSubscriber
jmleroux May 18, 2022
8be30fb
Hotfix: Fix external links for ChannelLocaleSubscriber
jmleroux May 18, 2022
a527ad5
Hotfix: Update Circle CI executor
jmleroux May 18, 2022
d5624e7
Merge branch 6.0 into master
jmleroux May 18, 2022
1fdb723
Pullup: Merge 6.0 into master (#1788)
jmleroux May 19, 2022
10e8c23
Update upgrade_from_50_to_60.rst
valerie-schneider Jun 2, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 9 additions & 26 deletions .circleci/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,40 +2,37 @@ version: 2.1
jobs:
build:
machine:
image: ubuntu-2004:202111-01
image: ubuntu-2004:2022.04.1
steps:
- checkout
- run: make build

check-external-link:
machine:
image: ubuntu-2004:202111-01
image: ubuntu-2004:2022.04.1
steps:
- checkout
- run: make lint

deploy_staging:
machine:
image: ubuntu-2004:202111-01
image: ubuntu-2004:2022.04.1
steps:
- checkout
- add_ssh_keys
- run:
name: Deploy on staging server
command: DEPLOY_HOSTNAME=$STAGING_HOSTNAME DEPLOY_PORT=$STAGING_PORT VERSION="6.0" make deploy
command: DEPLOY_HOSTNAME=$STAGING_HOSTNAME DEPLOY_PORT=$STAGING_PORT VERSION="master" make deploy

deploy_production:
machine:
image: ubuntu-2004:202111-01
image: ubuntu-2004:2022.04.1
steps:
- checkout
- add_ssh_keys
- run:
name: Deploy on production server
command: DEPLOY_HOSTNAME=$PROD_HOSTNAME DEPLOY_PORT=$PROD_PORT VERSION="6.0" make deploy

orbs:
pull-up: akeneo-orbs/[email protected]
command: DEPLOY_HOSTNAME=$PROD_HOSTNAME DEPLOY_PORT=$PROD_PORT VERSION="master" make deploy

workflows:
version: 2
Expand All @@ -45,14 +42,14 @@ workflows:
filters:
branches:
ignore:
- '6.0'
- master

deployment:
jobs:
- deploy_staging:
filters:
branches:
only: '6.0'
only: master
- approve_to_deploy_in_production:
type: approval
requires:
Expand All @@ -61,27 +58,13 @@ workflows:
requires:
- approve_to_deploy_in_production

pull_up:
jobs:
- pull-up/pull-up:
from: "6.0"
into: "master"
branch_prefix: "60_to_master"
github_token: MICHEL_TAG_TOKEN
github_username: "micheltag"
slack_webhook: "${SLACK_URL_PULL_UP}"
filters:
branches:
only:
- "6.0"

nightly:
triggers:
- schedule:
cron: "0 2 * * *"
filters:
branches:
only:
- "6.0"
- "master"
jobs:
- check-external-link
2 changes: 1 addition & 1 deletion Dockerfile
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
FROM akeneo/pim-php-dev:6.0
FROM akeneo/pim-php-dev:master
WORKDIR /home/akeneo/pim-docs/
ENV DEBIAN_FRONTEND=noninteractive

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,6 @@ Alias Argument Action
``partners_systemctl <job>`` ``status|start|stop|restart|enable|disable`` Show status, start/stop/restart or enable/disable job consumers. Refer to `this page <job_consumers_and_workers.rst>`_ for more details
============================ ============================================ ======


Third-party Software Installation
---------------------------------

Expand Down
32 changes: 23 additions & 9 deletions cloud_edition/flexibility_mode/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,24 +24,38 @@ Types of environments

The system components are based on :doc:`../../../install_pim/manual/system_requirements/system_requirements`.

Updates and migrations
----------------------

Updates can include **patches** and **new features**. Integrators are accountables for applying new patches and performing migrations on the PIM.
PIM updates and migrations
--------------------------

Following the `Semantic Version <https://semver.org>`_, PIM has 2 main updates:

- patches or minors versions:
Can include **bug fixes** and **new features**.
Integrators are accountable for applying new patches and performing migrations on the PIM.
You can refer to :doc:`../../../migrate_pim/upgrade_minor_version` for more details about the procedure.
- majors versions:
Requires **new versions** of software and various components.
Please contact us through the `Helpdesk > Cloud Flexibility and Serenity <https://akeneo.atlassian.net/servicedesk/customer/portal/8/group/23/create/93?summary=Technological%20stack%20upgrade%20for%20PIM&customfield_13302=12701&customfield_13395=13010&customfield_13395%3A1=13016&description=--%21--%20%20Operation%20scheduling%3A%0A--%21--%20%20%20%20-%202h%20downtime%20expected%0A--%21--%20%20%20%20-%20French%20Office%20Hours%0A--%21--%20%20%20%20-%20Should%20be%20scheduled%2048h%20in%20advance%0A--%21--%20%20Please%20offer%20us%20several%20dates%20and%20we%20will%20confirm%20the%20one%20that%20also%20corresponds%20to%20our%20availability>`_ to schedule the upgrade of the technological stack.
Then integrators are accountable for performing the PIM migration.
You can refer to :doc:`../../../migrate_pim/upgrade_major_version` for more details about the procedure.

Quarterly System updates
------------------------

You can refer to :doc:`../../../migrate_pim/index` for more details about the procedure.
In order for you to benefit the best of Flexibility experience, Akeneo schedules system updates on a quarterly basis.
These updates include **security patches** and **system improvements**.

.. note::
They will be scheduled every last Wednesday/Thursday of the quarter following these time slots:

Major upgrades can require **new versions** of software and various components.
Please contact us through the `Helpdesk > Cloud Flexibility and Serenity <https://akeneo.atlassian.net/servicedesk/customer/portal/8/group/23/create/93?summary=Technological%20stack%20upgrade%20for%20PIM&customfield_13302=12701&customfield_13395=13010&customfield_13395%3A1=13016&description=--%21--%20%20Operation%20scheduling%3A%0A--%21--%20%20%20%20-%202h%20downtime%20expected%0A--%21--%20%20%20%20-%20French%20Office%20Hours%0A--%21--%20%20%20%20-%20Should%20be%20scheduled%2048h%20in%20advance%0A--%21--%20%20Please%20offer%20us%20several%20dates%20and%20we%20will%20confirm%20the%20one%20that%20also%20corresponds%20to%20our%20availability>`_ to schedule the upgrade of the tech stack.
- Asia/Australia: Starting **Wednesday at 3pm CET/CEST**
- Europe: Starting **Wednesday at 6pm CET/CEST**
- US: Starting **Thursday at 9am CET/CEST**

Backups management
------------------

A snapshot of your production instance is made regularly and can be restored upon request.


Manage your environments
------------------------
.. toctree::
Expand Down
2 changes: 1 addition & 1 deletion conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@
# built documents.
#
# The short X.Y version.
version = os.getenv('PIM_VERSION', '6.0')
version = os.getenv('PIM_VERSION', 'master')

# Warning: These versions will be deleted on documentation deploy.
versions = os.getenv('PIM_VERSIONS', 'master')
Expand Down
6 changes: 3 additions & 3 deletions contribute_to_pim/create_connector.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ How to contribute to a Connector?

We're happy to connect the PIM to any third-party system!

* Begin by checking on the `Akeneo PIM Marketplace`_ that nobody published a connector for a 3rd party system
* Begin by checking on the `Akeneo App Store`_ that nobody published a connector for a 3rd party system
* Create your connector :doc:`/import_and_export_data/guides/create-connector`
* Reference it on the `Akeneo PIM Marketplace`_
* Reference it on the `Akeneo App Store`_

.. _Akeneo PIM Marketplace: https://marketplace.akeneo.com/
.. _Akeneo App Store: https://marketplace.akeneo.com/
12 changes: 6 additions & 6 deletions contribute_to_pim/tests/establishing_decorator_pattern.rst
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ Navigate And Change The Current Page
}

Selenium will know which URL to go to thanks to `the protected $path attribute
<https://github.com/akeneo/pim-community-dev/blob/6.0/tests/legacy/features/Context/Page/Role/Edit.php#L19>`_
<https://github.com/akeneo/pim-community-dev/blob/master/tests/legacy/features/Context/Page/Role/Edit.php#L19>`_
contained in *Context\\Page\\Role\\Edit*.

You may notice that this Gherkin method still uses the old implementation of Behat in Akeneo PIM.
Expand All @@ -102,7 +102,7 @@ This organization is very helpful to quickly find the context you are looking fo

We are working on permissions that are localized in the system main menu. So let's see the
`\\Pim\\Behat\\Context\\Domain\\System\\PermissionsContext
<https://github.com/akeneo/pim-community-dev/blob/6.0/tests/legacy/features/Behat/Context/Domain/System/PermissionsContext.php>`_.
<https://github.com/akeneo/pim-community-dev/blob/master/tests/legacy/features/Behat/Context/Domain/System/PermissionsContext.php>`_.

.. image:: images/PermissionsContext.png

Expand Down Expand Up @@ -149,12 +149,12 @@ Pages
_____

The current page is `Context\\Page\\Role\\Edit
<https://github.com/akeneo/pim-community-dev/blob/6.0/tests/legacy/features/Context/Page/Role/Edit.php>`_.
<https://github.com/akeneo/pim-community-dev/blob/master/tests/legacy/features/Context/Page/Role/Edit.php>`_.

When you call *Pim\\Behat\\Context\\NavigationContext->getCurrentPage()* the method will match "Role edit" to
*return new Context\\Page\\Role\\Edit()*. That's why all of our pages are located in a folder named after the name of
the Entity. In this folder, each action has its dedicated page such as Index.php, Creation.php, Edit.php as you can see
in the `Role folder <https://github.com/akeneo/pim-community-dev/tree/6.0/tests/legacy/features/Context/Page/Role>`_ for example.
in the `Role folder <https://github.com/akeneo/pim-community-dev/tree/master/tests/legacy/features/Context/Page/Role>`_ for example.

.. image:: images/edit.png

Expand Down Expand Up @@ -247,7 +247,7 @@ The name of the sub-folder is only the representative name of the element, no pr
have to be suffixed by "Decorator" like *DecoratedElementDecorator*.

The `Pim\\Behat\\Decorator\\Permission\\PermissionDecorator
<https://github.com/akeneo/pim-community-dev/blob/6.0/tests/legacy/features/Behat/Context/Domain/System/PermissionsContext.php>`_
<https://github.com/akeneo/pim-community-dev/blob/master/tests/legacy/features/Behat/Context/Domain/System/PermissionsContext.php>`_
adds behaviors to an Element to be able to navigate between groups and grant or revoke permissions for resources or groups.

.. image:: images/decorator.png
Expand Down Expand Up @@ -303,7 +303,7 @@ The method *$this->find()* is neither in the decorator nor in the abstract class

That's how we can call methods from the Element class inside decorators. And obviously, that's why all decorators must
extend `Pim\\Behat\\Decorator\\ElementDecorator
<https://github.com/akeneo/pim-community-dev/blob/6.0/tests/legacy/features/Behat/Decorator/ElementDecorator.php>`_.
<https://github.com/akeneo/pim-community-dev/blob/master/tests/legacy/features/Behat/Decorator/ElementDecorator.php>`_.

.. note::

Expand Down
2 changes: 1 addition & 1 deletion contribute_to_pim/tests/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ How behavior tests are architectured in the PIM?
================================================


The PIM comes with a set of Behat scenarios: https://github.com/akeneo/pim-community-dev/tree/6.0/tests/legacy/features
The PIM comes with a set of Behat scenarios: https://github.com/akeneo/pim-community-dev/tree/master/tests/legacy/features

.. warning::

Expand Down
4 changes: 2 additions & 2 deletions contribute_to_pim/translate.rst
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,13 @@ Then, copy the translations in the right folders:

.. code-block:: bash

cp -r crowdin_archive/6.0/Community/* your_app/vendor/akeneo/pim-community-dev/
cp -r crowdin_archive/master/Community/* your_app/vendor/akeneo/pim-community-dev/

If you use the Enterprise Edition, run this command too:

.. code-block:: bash

cp -r crowdin_archive/6.0/Enterprise/* your_app/vendor/akeneo/pim-enterprise-dev/
cp -r crowdin_archive/master/Enterprise/* your_app/vendor/akeneo/pim-enterprise-dev/

Then, update the parameters of `your_app/vendor/akeneo/pim-community-dev/src/Akeneo/Platform/Bundle/UIBundle/Resources/config/locale_provider.yml` to change the minimum percentage and add your new language (here, 10% and Hungarian):

Expand Down
4 changes: 2 additions & 2 deletions import_and_export_data/simple-import.rst
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
How import works
================

.. _minimal: https://github.com/akeneo/pim-community-dev/tree/6.0/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/minimal
.. _icecat: https://github.com/akeneo/pim-community-dev/tree/6.0/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/icecat_demo_dev
.. _minimal: https://github.com/akeneo/pim-community-dev/tree/master/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/minimal
.. _icecat: https://github.com/akeneo/pim-community-dev/tree/master/src/Akeneo/Platform/Bundle/InstallerBundle/Resources/fixtures/icecat_demo_dev

At any time, a set of data can be imported: products, attributes, users, etc.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ on selected products.
Prerequisite
------------
The mass edit action uses the `BatchBundle
<https://github.com/akeneo/pim-community-dev/tree/6.0/src/Akeneo/Tool/Bundle/BatchBundle>`_ in order to run mass edit in the background. Readers and Writers are already
<https://github.com/akeneo/pim-community-dev/tree/master/src/Akeneo/Tool/Bundle/BatchBundle>`_ in order to run mass edit in the background. Readers and Writers are already
created so in this cookbook we will focus on how to create a Mass Edit Action and create a Processor.
For more information on how to create Jobs, Readers, Processors, or Writers please see :doc:`/import_and_export_data/index`.

Expand Down
2 changes: 1 addition & 1 deletion manipulate_pim_data/non-product/create.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
How to Create Non-Product Objects
=================================

.. _SimpleFactoryInterface: https://github.com/akeneo/pim-community-dev/blob/6.0/src/Akeneo/Tool/Component/StorageUtils/Factory/SimpleFactoryInterface.php
.. _SimpleFactoryInterface: https://github.com/akeneo/pim-community-dev/blob/master/src/Akeneo/Tool/Component/StorageUtils/Factory/SimpleFactoryInterface.php

To create common objects, we rely on different methods depending on the complexity of the object. There are some examples on how to use these services.

Expand Down
6 changes: 6 additions & 0 deletions migrate_pim/upgrade/upgrade_from_40_to_50.rst
Original file line number Diff line number Diff line change
Expand Up @@ -234,3 +234,9 @@ From that point, you will have to migrate your bundle one by one.

Remember to check if they are still relevant, as each Akeneo version
brings new features.


Setting up the Events API
*************************

Configure your Events API with :doc:`/install_pim/manual/events_api`
2 changes: 1 addition & 1 deletion migrate_pim/upgrade/upgrade_from_50_to_60.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Disclaimer
**********

Make sure your production database is backed-up before performing the data migration.
The queue daemon(s) must be stopped as well.
The queue daemon(s) must be stopped as well (:doc:`/cloud_edition/flexibility_mode/docs/job_consumers_and_workers`).

Prepare your project for the new technical stack
************************************************
Expand Down
Loading