Naar hoofdinhoud gaan
De Capistrano-integratie zorgt ervoor dat er bij elke deploy een AppSignal deploy marker wordt aangemaakt. Lees meer over deploy markers. Enige handmatige configuratie kan vereist zijn.

​
Installatie

Zorg ervoor dat u het bestand appsignal/capistrano laadt in het Capfile van Capistrano. Dit zou automatisch moeten gebeuren wanneer u het commando appsignal install uitvoert tijdens de installatie. 
# Capfile
require 'capistrano'
# Other Capistrano requires.
require 'appsignal/capistrano'

​
Configuratie

​
appsignal_config

# deploy.rb
set :appsignal_config, name: 'My app'
appsignal_config stelt u in staat om elke configuratie die uit het configuratiebestand wordt geladen te overschrijven.

​
appsignal_env (vanaf gem versie 1.3)

# deploy.rb
set :stage, :alpha
set :appsignal_env, :staging
appsignal_env stelt u in staat om een andere AppSignal-omgeving te laden wanneer een stage-naam niet overeenkomt met de AppSignal-omgeving zoals genoemd in het AppSignal- configuratiebestand of de omgevingsvariabele.

​
appsignal_revision (vanaf gem versie 0.8.8)

Deze methode om deploy markers te rapporteren is verouderd en kan op elk moment in de toekomst worden verwijderd. Het rapporteren van deploy markers via deze methode is alleen nuttig voor kleine applicaties met één applicatie-instantie. Hiermee wordt op een specifiek tijdstip een nieuwe deploy marker aangemaakt, ongeacht de versie die de applicatie daadwerkelijk uitvoert. Dit betekent ook dat het foutgevoeliger is om gegevens onder de deploy te groeperen die er niet bij thuishoren. We detecteren deployment automatisch door het REVISION-bestand te lezen dat Capistrano sinds Ruby gem 4.5.18 aan de release-map toevoegt.
In Capistrano 2 kan AppSignal de revisie ophalen uit de Capistrano- configuratie. In Capistrano 3 is dit echter niet meer beschikbaar en wordt het aanbevolen om de revisie in te stellen. 
# deploy.rb
set :appsignal_revision, "my_revision"
De revisie kan handmatig worden ingesteld of lokaal uit de git-repository worden opgehaald. 
# Sets the current branch's git commit SHA as the revision
set :appsignal_revision, `git rev-parse --short HEAD`.strip
Als u de branch-configuratie-instelling van Capistrano gebruikt, kunt u git ook de commit-SHA van de geselecteerde branch laten ophalen. 
set :branch, "main"
# Sets the selected branch's git commit SHA as the revision
set :appsignal_revision, `git rev-parse --short #{fetch(:branch)}`.strip

​
appsignal_user (vanaf gem versie 2.4.0)

In combinatie met appsignal_revision (indien nodig) is het mogelijk om een deploy-gebruiker voor Capistrano-deploys aan te passen. Standaard gebruikt dit de lokale gebruikersnaam van het systeem, gelezen uit de omgevingsvariabele USER of USERNAME, dus het is niet nodig om dit te configureren als deze variabelen op het systeem beschikbaar zijn. Als u de deploy-gebruiker wel wilt aanpassen, stelt u de :appsignal_user config-optie in uw Capistrano-configuratie in. 
# deploy.rb
set :appsignal_user, "Jane" # Custom deploy user name

​
Voorbeeldapplicaties

We hebben twee voorbeeldapplicaties in onze voorbeeld-repository op GitHub. De voorbeelden laten zien hoe u AppSignal opzet in kleine Capistrano-applicaties terwijl u configuratiewaarden uit de omgeving laadt met gems zoals dotenv en Figaro.