Services configureren
In het bestand services.yaml
worden de services gedefinieerd die door Adobe Commerce worden ondersteund en gebruikt op cloudinfrastructuur, zoals MySQL, Redis en Elasticsearch of OpenSearch. U hoeft zich niet in te schrijven op externe serviceproviders. Dit bestand staat in de map .magento
van uw project.
Het plaatsingsmanuscript gebruikt de configuratiedossiers in de .magento
folder aan voorziening het milieu met de gevormde diensten. Een service wordt beschikbaar voor uw toepassing als deze wordt opgenomen in de eigenschap relationships
van het .magento.app.yaml
-bestand. Het services.yaml
dossier bevat het type en schijf waarden. Het type van dienst bepaalt de dienst naam en versie.
Het veranderen van een de dienstconfiguratie veroorzaakt een plaatsing aan voorziening het milieu met de bijgewerkte diensten, die de volgende milieu's beïnvloedt:
- Alle starteromgevingen, inclusief productie
master
- Pro-integratieomgevingen
Staging
en Production
slechts milieu's te installeren of bij te werken..magento.app.yaml
- en services.yaml
-bestanden op en geef de PHP-versie op in het ticket. Voor zelfbedienings veranderingen in PHP versie, uitbreidingen, of milieu montages, zie PHP montagesin configuratie van de Toepassing.Standaard en ondersteunde services
De cloudinfrastructuur ondersteunt en implementeert de volgende services:
U kunt standaardversies en schijfwaarden in het huidige, standaard services.yaml
dossierbekijken. In het volgende voorbeeld worden de services mysql
, redis
, opensearch
of elasticsearch
en rabbitmq
getoond die in het configuratiebestand services.yaml
zijn gedefinieerd:
mysql:
type: mysql:10.4
disk: 5120
redis:
type: redis:6.2
opensearch:
type: opensearch:2 # minor version not required; uses latest
disk: 1024
rabbitmq:
type: rabbitmq:3.9
disk: 1024
Servicewaarden
U moet de service-id en de configuratie van het servicetype opgeven type: <name>:<version>
. Als de service blijvende opslag gebruikt, moet u een schijfwaarde opgeven.
Gebruik de volgende indeling:
<service-id>:
type: <name>:<version>
disk: <value-MB>
service-id
De service-id
-waarde identificeert de service in het project. U kunt alleen alfanumerieke tekens in kleine letters gebruiken: a
tot z
en 0
tot 9
, zoals redis
.
Deze dienst-identiteitskaart waarde wordt gebruikt in het relationships
bezit van het .magento.app.yaml
configuratiedossier:
relationships:
redis: "<name>:redis"
U kunt meerdere instanties van elk servicetype een naam geven. U kunt bijvoorbeeld meerdere Redis-exemplaren gebruiken, een voor een sessie en een voor een cache.
redis:
type: redis:<version>
redis2:
type: redis:<version>
Het anders noemen van de dienst in het services.yaml
dossier verwijdert permanent het volgende:
- De bestaande service voordat u een service met de nieuwe naam maakt die u opgeeft.
- Alle bestaande gegevens voor de service worden verwijderd. De Adobe adviseert sterk dat u steun uw milieu van de Aanzetalvorens u de naam van een bestaande dienst verandert.
type
De type
-waarde geeft de servicenaam en -versie op. Bijvoorbeeld:
mysql:
type: mysql:10.4
disk
De disk
-waarde geeft de grootte aan van de permanente schijfopslag (in MB) die aan de service moet worden toegewezen. De diensten die blijvende opslag, zoals MySQL gebruiken, moeten een schijfwaarde verstrekken. Voor services die geheugen gebruiken in plaats van permanente opslag, zoals Redis, is geen schijfwaarde vereist.
mysql:
type: mysql:10.4
disk: 5120
Het huidige standaard opslagbedrag per project is 5 GB of 512 0MB. U kunt dit bedrag tussen uw toepassing en elk van zijn diensten verdelen.
Servicerelaties
In Adobe Commerce op de projecten van de wolkeninfrastructuur, de dienst verhoudingendie in het .magento.app.yaml
dossier worden gevormd bepalen welke diensten aan uw toepassing beschikbaar zijn.
U kunt de configuratiegegevens voor alle de dienstverhoudingen van de $MAGENTO_CLOUD_RELATIONSHIPS
omgevingsvariabele terugwinnen. De configuratiegegevens omvatten de de dienstnaam, type, en versie samen met om het even welke vereiste verbindingsdetails zoals havenaantal en login geloofsbrieven.
om verhoudingen in lokaal milieu te verifiëren:
-
Geef in uw lokale omgeving de relaties voor de actieve omgeving weer.
code language-bash magento-cloud relationships
-
Bevestig de
service
entype
in het antwoord. De reactie verstrekt verbindingsinformatie, zoals het IP adres en havenaantal.Afkorting van monsterrespons
code language-yaml redis: - ... type: 'redis:7.0' port: 6379 elasticsearch: - ... type: 'opensearch:2' port: 9200 database: - ... type: 'mysql:10.6' port: 3306
om verhoudingen in verre milieu's te verifiëren:
-
Gebruik SSH om u aan te melden bij de externe omgeving.
-
Maak een lijst van de gegevens van de relatieconfiguratie voor alle diensten die in het milieu worden gevormd.
code language-bash echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp
U kunt ook de volgende opdracht
ece-tools
gebruiken om relaties weer te geven:code language-bash php ./vendor/bin/ece-tools env:config:show services
-
Bevestig de
service
entype
in het antwoord. De reactie verstrekt verbindingsinformatie, zoals het IP adres en havenaantal en om het even welke vereiste gebruikersbenaming en wachtwoordgeloofsbrieven.
Serviceversies
Serviceversie en compatibiliteitsondersteuning voor Adobe Commerce op cloudinfrastructuur worden bepaald door versies die worden geïmplementeerd en getest op de cloudinfrastructuur en verschillen soms van versies die worden ondersteund door Adobe Commerce-implementaties op locatie. Zie {de vereisten van het 0} Systeem 🔗 in de gids van de Installatie voor een lijst van derdesoftware gebiedsdelen die de Adobe met specifieke versies van Adobe Commerce en van de Magento Open Source heeft getest.
Software EOL-controles
Tijdens het implementatieproces controleert het ece-tools
-pakket de geïnstalleerde serviceversies op de einddatums (EOL) voor elke service.
- Als een de dienstversie binnen drie maanden na de datum EOL is, toont een bericht in het opstellen logboek.
- Als de datum EOL in het verleden is, toont een waarschuwingsbericht.
Om de veiligheid van de opslag te handhaven, werk geïnstalleerde softwareversies bij alvorens zij EOL bereiken. U kunt de data EOL in het eol.yaml
dossier van 0} controleren-hulpmiddelen 🔗.
Migreren naar OpenSearch
Voor versie 2.4.4 van Adobe Commerce en recenter, zie de dienst van OpenSearch van de Opstelling.
Serviceversie wijzigen
U kunt de versie van de geïnstalleerde service upgraden voor compatibiliteit met de Adobe Commerce-versie die in uw cloud-omgeving is geïmplementeerd.
U kunt de de dienstversie voor een geïnstalleerde dienst niet direct degraderen. U kunt echter wel een service met de vereiste versie maken. Zie de dienstversie van de Verlaag.
Installatieversie van de service upgraden
U kunt de geïnstalleerde de dienstversie bevorderen door de de dienstconfiguratie in het services.yaml
dossier bij te werken.
-
Wijzig de
type
-waarde voor de service in het.magento/services.yaml
-bestand:Oorspronkelijke servicedefinitie
code language-yaml mysql: type: mysql:10.3 disk: 2048
Bijgewerkte servicedefinitie
code language-yaml mysql: type: mysql:10.4 disk: 5120
-
U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.
code language-bash git add .magento/services.yaml
code language-bash git commit -m "Upgrade MySQL from MariaDB 10.3 to 10.4."
code language-bash git push origin <branch-name>
Downgrade
U kunt een geïnstalleerde service niet rechtstreeks downgraden. U hebt twee opties:
-
Wijzig de naam van een bestaande service met de nieuwe versie, waardoor de bestaande service en gegevens worden verwijderd en er een nieuwe wordt toegevoegd.
-
Creeer de dienst en sla de gegevens van de bestaande dienst op.
Wanneer u de serviceversie wijzigt, moet u de serviceconfiguratie in het services.yaml
-bestand bijwerken en de relaties in het .magento.app.yaml
-bestand bijwerken.
om een de dienstversie te degraderen door de bestaande dienst anders te noemen:
-
Wijzig de naam van de bestaande service in het
.magento/services.yaml
-bestand en wijzig de versie.note warning WARNING Als u de naam van een bestaande service wijzigt, wordt deze vervangen en worden alle gegevens verwijderd. Als u de gegevens wilt behouden, maakt u een service in plaats van de naam van de bestaande service te wijzigen. Bijvoorbeeld, om de versie MariaDB voor de mysql dienst van versie 10.4 tot 10.3 te degraderen, verander de bestaande dienst-identiteitskaart en type configuratie.
Oorspronkelijke
services.yaml
definitiecode language-yaml mysql: type: mysql:10.4 disk: 5120
Nieuwe definitie
services.yaml
code language-yaml mysql2: type: mysql:10.3 disk: 5120
-
Werk de relaties in het
.magento.app.yaml
-bestand bij.Oorspronkelijke
.magento.app.yaml
configuratiecode language-yaml relationships: database: "mysql:mysql"
Bijgewerkte
.magento.app.yaml
configuratiecode language-yaml relationships: database: "mysql2:mysql"
-
U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.
om de dienst te degraderen door de dienst te creëren:
-
Voeg een de dienstdefinitie aan het
services.yaml
dossier voor uw project met de gedowngraded versiespecificatie toe. Zie mysql2 in het volgende voorbeeld:services.yaml
code language-yaml mysql: type: mysql:10.4 disk: 5120 mysql2: type: mysql:10.3 disk: 5120
-
Wijzig de relatieconfiguratie in het
.magento.app.yaml
dossier om de nieuwe dienst te gebruiken.Oorspronkelijke
.magento.app.yaml
configuratiecode language-yaml relationships: database: "mysql:mysql"
Nieuwe
.magento.app.yaml
configuratiecode language-yaml relationships: database: "mysql2:mysql"
-
U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.