Démarrage rapide

Prérequis

Une organization avec Outposts activé
Un jeton d’API v3 avec les périmètres Outposts appropriés :
- account.outposts.orchestrator pour les orchestrators qui gèrent les outposts (inclut le périmètre machine)
- account.outposts.machine pour les workers qui lisent la file d’attente et récupèrent/libèrent les sessions
Une machine (VM ou container) avec :
- Le Devin CLI installé
- Les dépendances de la machine
- Vos repositories clonés, avec des remotes configurés
- L’accès aux build tools, aux registries de packages, aux secrets et aux services internes dont vos sessions ont besoin

Votre machine
Docker

Les sessions s’exécutent directement sur la machine avec les autorisations associées à votre compte utilisateur. Nous recommandons d’exécuter le worker dans un répertoire dédié où vous êtes à l’aise de laisser un agent travailler librement — ou, mieux encore, sur une machine réservée à des tâches agentiques de longue durée, comme un Mac Mini sur votre bureau.

Installer le Devin CLI

Téléchargez et installez le Devin CLI :

curl -fsSL https://cli.devin.ai/install.sh | bash

Créer un outpost

Dans Devin Cloud, accédez à Settings → Environment → Outposts, puis cliquez sur le bouton “Create Outpost”.

Donnez un nom à votre Outpost et choisissez le type de machines qu’il prendra en charge (p. ex. Linux, Windows ou Mac). Ensuite, cliquez sur le bouton “Create”.

Boîte de dialogue de création d’un outpost

Après avoir créé votre Outpost, vous obtiendrez un jeton Outpost que les workers que vous souhaitez y affecter utiliseront pour s’authentifier auprès de Devin.Copiez le jeton et conservez-le dans un endroit sûr pour une utilisation ultérieure. Le jeton ne sera affiché qu’une seule fois lors de la création de l’Outpost.

Exécuter votre worker Outpost

Accédez au répertoire dans lequel vous souhaitez exécuter votre worker :

cd /path/to/worker/directory

Exécutez ensuite la commande devin worker start avec le nom de votre Outpost et le jeton que vous avez copiés précédemment :

devin worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

Démarrer une nouvelle session Outpost

Dans Devin Cloud, démarrez une nouvelle session et configurez-la pour qu’elle s’exécute sur votre Outpost. Sous “Configuration” → “Virtual environment”, vous verrez votre nouvel Outpost dans la liste. Sélectionnez-le pour y exécuter votre session.

Vous pouvez maintenant demander à Devin de commencer à développer sur votre machine ! Essayez quelque chose de simple, comme

Create a "hello world" python script for me

et regardez le script apparaître dans le répertoire de votre worker !

Prochaines étapes

Démarrez le worker dans un répertoire où se trouve votre code et demandez à Devin de développer à partir de celui-ci. Les sessions voient les dépôts clonés dans le répertoire de travail du worker. Pour traiter plus de sessions en parallèle, exécutez le worker sur davantage de machines pointant vers le même outpost : N workers servent N sessions simultanées, et les autres attendent dans la file d’attente.

Orchestration

Provisionnez automatiquement les machines à mesure que des sessions entrent dans la file d’attente, au lieu de conserver des workers persistants.

Intégrations

Exécutez votre outpost sur la plateforme que vous utilisez déjà — Namespace, Modal, E2B, et bien plus encore.

Créer un outpost

Sur Devin Cloud, accédez à Settings → Environment → Outposts, puis cliquez sur le bouton “Create Outpost”.

Donnez un nom à votre Outpost et choisissez Linux comme plateforme (vos conteneurs s’exécutent sous Linux). Cliquez ensuite sur le bouton “Create”.

Une fois votre Outpost créé, vous obtiendrez un token d’Outpost que les workers que vous souhaitez y affecter utiliseront pour s’authentifier auprès de Devin.Copiez le token et conservez-le dans un endroit sûr pour une utilisation ultérieure. Le token ne sera affiché qu’une seule fois, lors de la création de l’Outpost.

Créer une image de worker

Partez de l’image officielle de Devin CLI (public.ecr.aws/e0h8a4b6/devin-cli) en y ajoutant les dépendances de la machine ainsi que tous les dépôts ou outils dont vos sessions ont besoin :

Dockerfile

# Le Devin CLI est préinstallé et constitue l'entrypoint de l'image.
# Utilisez :stable, ou épinglez un tag de version spécifique du CLI.
FROM public.ecr.aws/e0h8a4b6/devin-cli:stable

# git est requis ; ffmpeg active les fonctionnalités d'enregistrement d'écran
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates git ffmpeg \
    && rm -rf /var/lib/apt/lists/*

# Le répertoire dans lequel le worker s'exécute
WORKDIR /repos

# Si nécessaire, clonez les dépôts dont vos sessions ont besoin :
# RUN git clone https://github.com/your-org/app.git \
#     && git clone https://github.com/your-org/infra.git

CMD ["worker", "start"]

Ou demandez à Devin de créer un Dockerfile :

Écris un Dockerfile pour une image worker Devin Outposts. Base-la sur
public.ecr.aws/e0h8a4b6/devin-cli:stable, qui a le Devin CLI préinstallé
en tant qu'entrypoint de l'image. Installe git et ffmpeg. Clone ces dépôts
dans le répertoire de travail où le worker s'exécute : <your repos>. La commande
par défaut doit être ["worker", "start"].

Les fonctionnalités du Browser nécessitent Chrome ou Chromium dans l’image, avec DEVIN_CHROME_PATH pointant vers le binaire. L’image de base est Ubuntu, et le package apt chromium d’Ubuntu est un stub Snap qui ne fonctionne pas dans les conteneurs — pour les images amd64, installez plutôt Google Chrome :

RUN apt-get update && apt-get install -y --no-install-recommends curl \
    && curl -fsSL https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -o /tmp/chrome.deb \
    && apt-get install -y --no-install-recommends /tmp/chrome.deb \
    && rm /tmp/chrome.deb && rm -rf /var/lib/apt/lists/*
ENV DEVIN_CHROME_PATH=/usr/bin/google-chrome

Pour les dépôts privés, intégrez les identifiants avec le mécanisme de votre choix (p. ex. les build secrets) afin que les clones et les remotes fonctionnent au moment de l’exécution.Lorsque votre Dockerfile vous convient, construisez l’image :

docker build -t devin-worker .

Démarrez votre worker Outpost

Démarrez un conteneur à partir de votre image avec la commande worker start, en indiquant le nom de votre Outpost et le jeton copié précédemment (le point d’entrée de l’image est Devin CLI, donc les arguments sont transmis directement à devin) :

docker run devin-worker \
  worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

Démarrer une nouvelle session Outpost

Sur Devin Cloud, démarrez une nouvelle session et configurez-la pour qu’elle s’exécute sur votre Outpost. Dans “Configuration” → “Environnement virtuel”, votre nouvel Outpost apparaîtra dans la liste. Sélectionnez-le pour y exécuter votre session.

Vous pouvez maintenant demander à Devin de lancer un build dans votre container ! Essayez quelque chose de simple comme

Create a "hello world" python script for me

Et regardez le script apparaître dans le répertoire de travail du conteneur !

Étapes suivantes

Intégrez les repositories sur lesquels vous souhaitez que Devin travaille dans l’image et demandez à Devin d’effectuer des builds par-dessus — les sessions voient les repositories extraits dans le répertoire de travail du worker. Pour traiter davantage de sessions en parallèle, lancez davantage de containers pointant vers le même outpost : N workers traitent N sessions simultanées, et les autres attendent dans la file d’attente.

Orchestration

Provisionnez automatiquement des conteneurs lorsque des sessions sont mises en file d’attente, au lieu de maintenir des workers persistants.

Intégrations

Exécutez votre outpost sur la plateforme que vous utilisez déjà — Namespace, Modal, E2B, et bien d’autres.

Prise en main

Concepts essentiels

Mise en place de Devin

Travailler avec Devin

Guides produit

Intégrations

Administration

Notes de version

Prochaines étapes

Orchestration

Intégrations

Étapes suivantes

Orchestration

Intégrations

​Prochaines étapes

Orchestration

Intégrations

​Étapes suivantes

Orchestration

Intégrations

Prochaines étapes

Étapes suivantes