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
TIP
Voor Pro projecten, moet u een kaartje van de Steun van Adobe Commercevoorleggen om dienstenin Staging en Production slechts milieu's te installeren of bij te werken.
Geef aan welke servicewijzigingen nodig zijn, neem de bijgewerkte .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.
Voor veranderingen in a levende milieu van de Productie (Pro slechts), moet u een minimum van 48 uurbericht verstrekken om het de infrastructuurteam van de Wolk voldoende tijd toe te staan om middelen te marshal en een veilige verbetering te leiden.

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:

  1. Geef in uw lokale omgeving de relaties voor de actieve omgeving weer.

    code language-bash
    magento-cloud relationships
    
  2. Bevestig de service en type 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:

  1. Gebruik SSH om u aan te melden bij de externe omgeving.

  2. 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
    
  3. Bevestig de service en type 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

WARNING
Elasticsearch 7.11 en hoger wordt niet ondersteund voor Adobe Commerce op cloudinfrastructuur. Adobe Commerce-versies 2.3.7-p3, 2.4.3-p2 en 2.4.4 en hoger ondersteunen de OpenSearch-service. De installaties ter plaatse blijven Elasticsearch steunen.

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.

  1. 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
    
  2. 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:

  1. 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.

  2. 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:

  1. 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 definitie

    code language-yaml
    mysql:
        type: mysql:10.4
        disk: 5120
    

    Nieuwe definitie services.yaml

    code language-yaml
    mysql2:
         type: mysql:10.3
         disk: 5120
    
  2. Werk de relaties in het .magento.app.yaml -bestand bij.

    Oorspronkelijke .magento.app.yaml configuratie

    code language-yaml
    relationships:
        database: "mysql:mysql"
    

    Bijgewerkte .magento.app.yaml configuratie

    code language-yaml
    relationships:
        database: "mysql2:mysql"
    
  3. U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.

om de dienst te degraderen door de dienst te creëren:

  1. 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
    
  2. Wijzig de relatieconfiguratie in het .magento.app.yaml dossier om de nieuwe dienst te gebruiken.

    Oorspronkelijke .magento.app.yaml configuratie

    code language-yaml
    relationships:
        database: "mysql:mysql"
    

    Nieuwe .magento.app.yaml configuratie

    code language-yaml
    relationships:
        database: "mysql2:mysql"
    
  3. U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26