Démarrage rapide

Prérequis

Une organisation avec Outposts activé
Un jeton d’API v3 avec les périmètres Outposts appropriés :
- account.outposts.orchestrator pour les orchestrateurs qui gèrent les outposts (implique le périmètre machine)
- account.outposts.machine pour les workers qui lisent la file d’attente et prennent en charge/libèrent les sessions
Une machine (VM ou conteneur) avec :
- Le Devin CLI installé
- Les dépendances de la machine
- Vos dépôts clonés, avec des dépôts distants configurés
- L’accès aux build tools, aux registres de packages, aux secrets et aux services internes nécessaires à vos sessions

Votre machine
Docker

Les sessions s’exécutent directement sur la machine avec les autorisations de votre utilisateur. Nous vous 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 aux 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 desservira (p. ex. Linux, Windows ou Mac). Cliquez ensuite sur le bouton “Create”.

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

Après avoir créé votre Outpost, vous obtiendrez un token Outpost que les workers que vous souhaitez lui attribuer 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.

Exécuter votre worker Outpost

Accédez à un 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 token que vous avez copié 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”, votre nouvel Outpost apparaîtra dans la liste. Sélectionnez-le pour y exécuter votre session.

Vous pouvez maintenant demander à Devin de commencer à build sur votre machine ! Essayez quelque chose de simple comme

Crée un script Python « hello world » pour moi

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

Étapes suivantes

Démarrez le worker dans un répertoire où se trouve votre code et demandez à Devin de build dessus. Les sessions voient les repositories extraits dans le répertoire de travail du worker. Pour servir davantage de sessions en parallèle, exécutez le worker sur plus de machines pointant vers le même outpost : N workers servent N sessions simultanées, et le reste attend dans la file d’attente.

Orchestration

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

Intégrations

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

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

Après avoir créé votre Outpost, vous recevrez un token d’Outpost que les workers que vous souhaitez y assigner utiliseront pour s’authentifier auprès de Devin.Copiez le token et conservez-le en lieu sûr pour l’utiliser plus tard. 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 ajoutant les dépendances de la machine ainsi que tous les dépôts ou outils nécessaires à vos sessions :

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

# Facultativement, 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 pour vous :

Écris un Dockerfile pour une image worker Devin Outposts. Base-toi sur
public.ecr.aws/e0h8a4b6/devin-cli:stable, qui intègre 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 du worker : <your repos>. La commande
par défaut doit être ["worker", "start"].

Les fonctionnalités 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 (par ex. les secrets de build) afin que le clonage et les dépôts distants fonctionnent à l’exécution.Une fois votre Dockerfile prêt, lancez le build de l’image :

docker build -t devin-worker .

Lancez votre worker Outpost

Lancez un conteneur à partir de votre image avec la commande worker start, en indiquant le nom de votre Outpost et le token que vous avez copié plus tôt (le point d’entrée de l’image est le Devin CLI, donc les arguments sont passés 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. Sous “Configuration” → “Environnement virtuel”, votre nouvel Outpost apparaît dans la liste. Sélectionnez-le pour y exécuter votre session.

Vous pouvez maintenant demander à Devin de commencer le build dans votre conteneur ! Essayez quelque chose de simple comme

Create a "hello world" python script for me

Et voyez 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

Approvisionnez automatiquement des conteneurs au fur et à mesure que les sessions sont mises en file d’attente, plutôt que de maintenir des workers persistants.

Intégrations

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

Prise en main

Concepts essentiels

Mise en place de Devin

Travailler avec Devin

Guides produit

Intégrations

Administration

Notes de version

Étapes suivantes

Orchestration

Intégrations

Étapes suivantes

Orchestration

Intégrations

​Étapes suivantes

Orchestration

Intégrations

​Étapes suivantes

Orchestration

Intégrations

Étapes suivantes

Étapes suivantes