ATAMYA cloud connector

Konfigurationsanleitung

Dieses CDK-Projekt erstellt die notwendige Infrastruktur auf AWS, um Daten von der ATAMYA-Plattform wiederholt einer Shopware-Instanz zuzuordnen. Es stellt mehrere Lambda-Funktionen, eine SQS-Warteschlange, eine Step Functions-Zustandsmaschine und einen Eventbridge-Zeitplan bereit, um den Workflow auszulösen.

Das Auslösen des Workflows erfolgt über einen Eventbridge-Zeitplan, der in der YAML-Konfigurationsdatei konfiguriert werden kann. Darüber hinaus ist es möglich, den Workflow manuell auszulösen, indem die Step Functions-Zustandsmaschine gestartet wird. Um zu verhindern, dass der Löschvorgang im Workflow ausgelöst wird, setzen Sie triggerDeleteWithWorkflow in der Konfigurationsdatei auf false oder gehen Sie zum Parameter Store und setzen Sie den Wert dieses Parameters auf false: /workflow/triggerDelete

Um die Konfiguration für das Projekt einzurichten, erstellen Sie einfach eine YAML-Datei für Ihre Umgebung im Konfigurationsverzeichnis. Z. B. „dev.yaml“, „test.yaml“, „prod.yaml“. In der Konfigurationsdatei müssen die folgenden Eigenschaften für ATAMYA und Shopware festgelegt werden.

Geheimwerte für ATAMYA und Shopware müssen im Secrets Manager in der AWS Management Console als JSON Secrets festgelegt werden. Um diese Werte zu speichern, gehen Sie zur AWS Management Console und öffnen Sie Secrets Manager. Dann:

Speichern Sie ein neues Geheimnis

Wählen Sie den Geheimnistyp -> Anderer Geheimnistyp

Wählen Sie JSON-Schlüssel/-Wert

Geben Sie die Anmeldeinformationen im JSON-Format ein:

Benutzeranmeldeinformationen müssen wie folgt gespeichert werden: {"username":"...","password":"..."}.

Clientanmeldeinformationen müssen wie folgt gespeichert werden: {"clientId":"...","clientSecret":"..."}.

Weiter

Geheimnisname -> legen Sie den entsprechenden Namen fest, den Sie in der YAML-Datei konfiguriert haben: ${neoClientCredentialsId} / ${neoUserCredentialsId} / ${shopwareClientCredentialsId}

Weiter

Weiter

Speichern

Dies muss für ATAMYA-Anmeldeinformationen und Shopware-Clientanmeldeinformationen durchgeführt werden.

Secrets Manager-Referenz: https://docs.aws.amazon.com/de_de/secretsmanager/latest/userguide/create_secret.html

Informationen zum Konfigurieren des Zeitplanparameters finden Sie auf diesen Seiten: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html

https://docs.aws.amazon.com/lambda/latest/dg/services-cloudwatchevents-expressions.html

Gültige Zeitplanwerte sind z. B.:

rate(1 Stunde)

cron(0 * * * ? *)

Legen Sie die erforderlichen Umgebungsvariablen fest:

export ENVIRONMENT={test/dev/prod}

Legen Sie die AWS-Kontoinformationen fest:

export AWS_ACCESS_KEY_ID=${accessKey} export AWS_SECRET_ACCESS_KEY=${secretAccessKey} export AWS_SESSION_TOKEN=${sessionToken}

Führen Sie npm run deploy aus, um die Bereitstellung auf dem konfigurierten Konto durchzuführen.