Schnellstart-On-Premise-Installation
Die Anweisungen auf dieser Seite beschreiben, wie Sie Adobe Commerce auf einer selbstgehosteten Infrastruktur installieren. Eine Anleitung zum Aktualisieren einer vorhandenen Installation finden Sie im Upgrade-Handbuch.
Adobe verwendet Composer um Adobe Commerce-Komponenten und ihre Abhängigkeiten zu verwalten. Die Verwendung von Composer zum Abrufen des Adobe Commerce-Metapakets bietet die folgenden Vorteile:
- Wiederverwenden von Drittanbieterbibliotheken ohne Bündelung mit Quellcode
- Verringern Sie Erweiterungskonflikte und Kompatibilitätsprobleme mithilfe einer komponentenbasierten Architektur mit robuster Abhängigkeitsverwaltung
- Einhaltung der Standards PHP-Framework Interoperability Group (FIG)
- Magento Open Source mit anderen Komponenten neu packen
- Verwenden der Adobe Commerce-Software in einer Produktionsumgebung
Voraussetzungen
Bevor Sie fortfahren, müssen Sie Folgendes tun:
- Alle erforderlichen Aufgaben“.
- Composer installieren.
- Abrufen Authentifizierungsschlüssel zum Adobe Commerce Composer-Repository.
Als Dateisystembesitzer anmelden
Erfahren Sie mehr über Eigentümerschaft, Berechtigungen und den Dateisystembesitzer im Thema Übersicht über Eigentümerschaft und Berechtigungen.
So wechseln Sie zum Dateisystembesitzer:
-
Melden Sie sich beim Anwendungsserver als Benutzer an oder wechseln Sie zu einem Benutzer mit Berechtigungen zum Schreiben in das Dateisystem.
Wenn Sie die Bash-Shell verwenden, können Sie die folgende Syntax verwenden, um zum Dateisystembesitzer zu wechseln und den Befehl gleichzeitig einzugeben:
code language-bash su <file system owner> -s /bin/bash -c <command>
Wenn der Dateisystembesitzer keine Anmeldungen zulässt, können Sie Folgendes tun:
code language-bash sudo -u <file system owner> <command>
-
Um CLI-Befehle aus einem beliebigen Verzeichnis auszuführen, fügen Sie
<app_root>/bin
zu IhremPATH
hinzu.Da Shell unterschiedliche Syntaxen haben, sollten Sie einen Verweis wie unix.stackexchange.com heranziehen.
Beispiel-Bash-Shell für CentOS:
code language-bash export PATH=$PATH:/var/www/html/magento2/bin
Optional können Sie die Befehle wie folgt ausführen:
cd <app_root>/bin
und als./magento <command name>
ausführenapp_root>/bin/magento <command name>
<app_root>
ist ein Unterverzeichnis Ihres Webserver-Stammverzeichnisses
Abrufen des Metapakets
So rufen Sie das Adobe Commerce-Metapaket ab:
-
Melden Sie sich bei Ihrem Anwendungs-Server als oder wechseln Sie zum Dateisystembesitzer.
-
Wechseln Sie in das Verzeichnis des Webservers docroot oder in ein Verzeichnis, das Sie als virtuellen Host docroot konfiguriert haben.
-
Erstellen Sie ein Composer-Projekt mit einem Commerce-Metapaket.
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
Geben Sie nach Aufforderung Ihre Authentifizierungsschlüssel ein. Öffentliche und private Schlüssel werden von Commerce Marketplace - Zugriffsschlüssel erstellt und konfiguriert. Kopieren Sie für die
username
den Wert des öffentlichen Schlüssels und fügen Sie ihn ein. Kopieren Sie für diepassword
den Wert für den privaten Schlüssel und fügen Sie ihn ein.note note NOTE Wenn Sie eine Composer [auth.json](https://experienceleague.adobe.com/de/docs/commerce-cloud-service/user-guide/develop/authentication-keys)
-Datei oder Umgebungsvariable verwenden, die mit Ihren Commerce-Authentifizierungsschlüsseln konfiguriert wurde, werden Sie nicht aufgefordert, Authentifizierungsschlüssel einzugeben.Wenn Fehler wie
Could not find package...
oder...no matching package found
auftreten, stellen Sie sicher, dass der Befehl keine Tippfehler enthält. Wenn weiterhin Fehler auftreten, sind Sie möglicherweise nicht berechtigt, Adobe Commerce herunterzuladen. Wenden Sie sich an den Adobe CommerceSupport, um Hilfe zu erhalten.Siehe Fehlerbehebung für Hilfe bei weiteren Fehlern.
Beispiel - Nebenversion
Nebenversionen enthalten neue Funktionen, Qualitätskorrekturen und Sicherheitskorrekturen. Verwenden Sie Composer, um eine Nebenversion anzugeben. Um beispielsweise das Metapaket Adobe Commerce 2.4.6 anzugeben:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Beispiel - Qualitäts-Patch
Qualitäts-Patches enthalten hauptsächlich funktionale und Sicherheitskorrekturen. Sie können jedoch manchmal auch neue, abwärtskompatible Funktionen enthalten. Verwenden Sie Composer, um einen Qualitäts-Patch herunterzuladen. Um beispielsweise das Metapaket Adobe Commerce 2.4.6 anzugeben:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Beispiel - Sicherheits-Patch
Sicherheits-Patches enthalten nur Sicherheitskorrekturen. Sie wurden entwickelt, um den Upgrade-Prozess schneller und einfacher zu machen.
Sicherheits-Patches verwenden die Composer-Namenskonvention 2.4.6-px
. Verwenden Sie Composer, um einen Patch anzugeben. So laden Sie beispielsweise das Adobe Commerce 2.4.6-p1-Metapaket herunter:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
Dateiberechtigungen festlegen
Sie müssen vor der Installation von Adobe Commerce Lese- und Schreibberechtigungen für die Webservergruppe festlegen. Dies ist erforderlich, damit die Befehlszeile Dateien in das Dateisystem schreiben kann.
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
Installieren des Programms
Sie müssen die Befehlszeile verwenden, um Adobe Commerce zu installieren.
In diesem Beispiel wird davon ausgegangen, dass der Installationsordner magento2ee
heißt, sich der db-host
auf demselben Computer befindet (localhost
) und dass die db-name
, db-user
und db-password
alle magento
sind:
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname
anpassen. Adobe empfiehlt jedoch, diese Option wegzulassen und zuzulassen, dass der Installationsbefehl automatisch einen zufälligen URI generiert. Ein zufälliger URI ist für Hacker oder bösartige Software schwieriger auszunutzen. Der URI wird nach Abschluss der Installation in Ihrer Konsole angezeigt.Befehlsübersicht
Um eine vollständige Liste der Befehle anzuzeigen, geben Sie Folgendes ein:
bin/magento list
Um Hilfe zu einem bestimmten Befehl zu erhalten, geben Sie Folgendes ein:
bin/magento help <command>
Beispiel:
bin/magento help setup:install
bin/magento help cache:enable
In der folgenden Tabelle sind die verfügbaren Befehle zusammengefasst. Befehle werden nur in Form einer Zusammenfassung angezeigt. Weitere Informationen zu einem Befehl erhalten Sie, wenn Sie auf den Link in der Spalte Befehl klicken.
magento setup:install
magento setup:uninstall
magento setup:upgrade
magento maintenance:{enable/disable}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
Bereitstellungskonfiguration
Aktivieren Sie mindestens die
Magento_User
und Magento_Authorization
ModuleDatenbank (am einfachsten verwenden Sie
bin/magento setup:upgrade
)magento list
magento help
Häufige Argumente
Die folgenden Argumente gelten für alle Befehle. Diese Befehle können entweder vor oder nach der Installation der Anwendung ausgeführt werden:
--help
-h
./magento help setup:install
oder ./magento help setup:config:set
.--quiet
-q
--no-interaction
-n
--verbose=1,2,3
-v, -vv, -vvv
--verbose=3
oder -vvv
die ausführlichste Ausgabe als Debugging-Ausführlichkeit an. Der Standardwert ist --verbose=1
oder -v
.--version
-V
--ansi
--no-ansi