Configuration des variables d’environnement

fichier env

Avant de commencer le développement des travailleurs d’Asset compute, assurez-vous que le projet est configuré avec les informations d’enregistrement Adobe I/O et Cloud. Ces informations sont stockées dans .env du projet, qui n'est utilisé que pour le développement local, et non dans Git. Le fichier .env fournit un moyen pratique d’exposer les paires clé/valeur à l’environnement de développement local de l’Asset compute local. Lorsque déployait les travailleurs d’Asset compute vers Adobe I/O Runtime, le fichier .env n’est pas utilisé, mais un sous-ensemble de valeurs est transmis par le biais de variables d’environnement. D’autres paramètres et secrets personnalisés peuvent également être stockés dans le fichier .env, tels que les informations d’identification de développement pour les services Web tiers.

Référencer private.key

clé privée

Ouvrez le fichier .env, annulez la mise en commentaire de la clé ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH et indiquez le chemin absolu sur votre système de fichiers vers le private.key qui correspond au certificat public ajouté à votre projet Adobe I/O FireFly.

  • Si votre paire de clés a été générée par Adobe I/O, elle a été automatiquement téléchargée dans le cadre du config.zip.
  • Si vous avez fourni la clé publique à Adobe I/O, vous devriez également être en possession de la clé privée correspondante.
  • Si vous ne disposez pas de ces paires de clés, vous pouvez générer de nouvelles paires de clés ou télécharger de nouvelles clés publiques au bas de :
    https://console.adobe.com > Votre projet de luciole d'Asset compute > Workspaces @ Development > Service Account (JWT).

Rappelez-vous que le fichier private.key ne doit pas être archivé dans Git car il contient des secrets, mais qu'il doit être stocké dans un endroit sûr en dehors du projet.

Par exemple, sur macOS, ceci peut se présenter comme suit :

...
ASSET_COMPUTE_PRIVATE_KEY_FILE_PATH=/Users/example-user/credentials/aem-guides-wknd-asset-compute/private.key
...

Configuration des informations d’identification de l’Enregistrement Cloud

Le développement local des employés d'Asset compute nécessite l'accès à l'enregistrement de nuage. Les informations d’identification de l’enregistrement cloud utilisées pour le développement local sont fournies dans le fichier .env.

Ce tutoriel préfère l'utilisation de l'Enregistrement Azure Blob, cependant Amazon S3 et ses clés correspondantes dans le fichier .env peuvent être utilisées à la place.

Utilisation de l'Enregistrement Azure Blob

Supprimez les commentaires et renseignez les clés suivantes dans le fichier .env, puis renseignez-les avec les valeurs de l'enregistrement de cloud mis en service sur Azure Portal.

Enregistrement Blob Azure

  1. Valeur de la clé AZURE_STORAGE_CONTAINER_NAME
  2. Valeur de la clé AZURE_STORAGE_ACCOUNT
  3. Valeur de la clé AZURE_STORAGE_KEY

Par exemple, ceci peut ressembler à (valeurs pour l’illustration uniquement) :

...
AZURE_STORAGE_ACCOUNT=aemguideswkndassetcomput
AZURE_STORAGE_KEY=Va9CnisgdbdsNJEJBqXDyNbYppbGbZ2V...OUNY/eExll0vwoLsPt/OvbM+B7pkUdpEe7zJhg==
AZURE_STORAGE_CONTAINER_NAME=asset-compute
...

Le fichier .env résultant se présente comme suit :

Informations d'identification de l'Enregistrement Azure Blob

Si vous n'utilisez PAS l'Enregistrement Blob Microsoft Azure, supprimez ou laissez-les en commentaire (en préfixe avec #).

Utilisation de l’enregistrement cloud Amazon S3

Si vous utilisez l’enregistrement cloud Amazon S3 sans commentaire et que vous renseignez les clés suivantes dans le fichier .env.

Par exemple, ceci peut ressembler à (valeurs pour l’illustration uniquement) :

...
S3_BUCKET=aemguideswkndassetcompute
AWS_ACCESS_KEY_ID=KKIXZLZYNLXJLV24PLO6
AWS_SECRET_ACCESS_KEY=Ba898CnisgabdsNJEJBqCYyVrYttbGbZ2...OiNYExll0vwoLsPtOv
AWS_REGION=us-east-1
...

Validation de la configuration du projet

Une fois le projet d'Asset compute généré configuré, validez la configuration avant d'apporter des modifications au code pour vous assurer que les services de prise en charge sont configurés, dans les fichiers .env.

Outil de développement de l'Asset compute début pour le projet d'Asset compute :

  1. Ouvrez une ligne de commande dans la racine du projet d'Asset compute (dans le code VS, vous pouvez l'ouvrir directement dans l'IDE via Terminal > New Terminal) et exécutez la commande :

    $ aio app run
    
  2. L'outil de développement d'Asset compute local s'ouvre dans votre navigateur Web par défaut à l'adresse http://localhost:9000.

    exécution de l’application aio

  3. Recherchez les messages d’erreur dans la sortie de ligne de commande et dans le navigateur Web au fur et à mesure que l’outil de développement s’initialise.

  4. Pour arrêter l'outil de développement d'Asset compute, appuyez sur Ctrl-C dans la fenêtre qui a exécuté aio app run pour arrêter le processus.

Résolution des incidents

Sur cette page