licorne - En ligne dans le Cloud

PROGRAMME:

Nom

unicorn - une commande de type rackup pour lancer le serveur HTTP Unicorn

SYNOPSIS

licorne [-c FICHIER_CONFIG] [-E ENV_RACK] [-D] [FICHIER_RACKUP]

DESCRIPTION

A accumulerCommande de type (1) pour lancer des applications Rack avec Unicorn. Elle devrait être
démarré dans la racine de votre application (APP_ROOT), mais la directive « working_directory » peut être
utilisé dans le CONFIG_FILE.

Bien qu'Unicorn prenne une myriade d'options de ligne de commande pour la compatibilité avec rubisde Géographie (1) et avec la
accumuler(1), il est recommandé de s'en tenir aux quelques options de ligne de commande spécifiées dans le
SYNOPSIS et utilisez le CONFIG_FILE autant que possible.

RACK-UP DOSSIER

La valeur par défaut est "config.ru" dans APP_ROOT. Il doit s'agir du même fichier utilisé par accumuler(1)
et d'autres lanceurs Rack, il utilise le Support :: Constructeur DSL

Les options de ligne de commande intégrées sont principalement analysées pour la compatibilité avec accumuler(1) mais
fortement déconseillé.

UNICORN OPTIONS

-c, --config-fichier CONFIG_FILE
Chemin d'accès au fichier de configuration spécifique à Unicorn. Le fichier de configuration est implémenté en tant que Ruby
DSL, donc le code Ruby peut être exécuté. Voir le RDoc/ri pour le Licorne::Configurateur
classe pour la liste complète des directives disponibles dans le DSL. Utiliser une classe absolue
le chemin pour CONFIG_FILE est recommandé car il crée plusieurs instances de Unicorn
facilement distinguable lors de la visualisation ps(1) sortie.

-RÉ, --démoniser
Exécutez démonisé en arrière-plan. Le processus est détaché du contrôle
Le terminal et l'entrée standard sont redirigés vers « /dev/null ». Contrairement à de nombreux démons UNIX courants,
nous ne chdirons pas à "/" lors de la démonisation pour permettre plus de contrôle sur le
processus de démarrage/mise à niveau. Sauf indication contraire dans le CONFIG_FILE, stderr et stdout
sera également redirigé vers "/dev/null".

-ET, --env RACK_ENV
Exécuter sous le RACK_ENV donné. Voir la section ENVIRONNEMENT DU RACK pour plus de détails.

-l, --Ecoutez ADRESSE
Écoute sur une ADRESSE donnée. L'ADRESSE peut être sous la forme HOST:PORT ou PATH,
HOST:PORT signifie un socket TCP et PATH est censé être un chemin vers un UNIX
socket de domaine. La valeur par défaut est « 0.0.0.0:8080 » (toutes les adresses sur le port TCP 8080).
déploiements de production, en spécifiant la directive « listen » dans CONFIG_FILE est
recommandé car il permet un réglage fin des options de socket.

-N, --pas de middleware par défaut
Désactive le chargement du middleware impliqué par RACK_ENV. Ceci contourne la configuration.
documenté dans la section ENVIRONNEMENT RACK, mais permet toujours d'utiliser RACK_ENV
à des fins spécifiques à l'application/au cadre.

RACK-UP COMPATIBILITÉ OPTIONS

-o, --hôte HÔTE
Écoute sur un socket TCP appartenant à l'hôte, la valeur par défaut étant « 0.0.0.0 » (toutes les adresses). Si
spécifié plusieurs fois sur la ligne de commande, seule la dernière valeur spécifiée prend
effet. Cette option n'existe que pour la compatibilité avec le accumuler(1) commande, utiliser
Il est recommandé d'utiliser le commutateur « -l »/« --listen ».

-p, --Port PORT
Écoutez sur le PORT TCP spécifié, la valeur par défaut est 8080. Si spécifié plusieurs fois sur
la ligne de commande, seule la dernière valeur spécifiée prend effet. Cette option seulement
existe pour la compatibilité avec le accumuler(1) commande, utilisation du commutateur « -l »/« --listen »
est recommandé à la place.

-Oui, --serveur SERVEUR
No-op, cela n'existe que pour la compatibilité avec accumuler (1).

RUBIS OPTIONS

-e, --évaluation LINE
Évaluez une LIGNE de code Ruby. Cette évaluation se produit immédiatement lorsque la commande-
la ligne est en cours d'analyse.

-ré, --déboguer
Activez le mode débogage, la variable $DEBUG est définie sur true.

-w, --avertir
Activez les avertissements détaillés, la variable $VERBOSE est définie sur true.

-JE, --comprendre PATH
spécifiez $LOAD_PATH. PATH sera précédé de $LOAD_PATH. Le caractère ':' peut
être utilisé pour délimiter plusieurs répertoires. Cette directive peut être utilisée plus de
une fois que. Les modifications de $LOAD_PATH ont lieu immédiatement et dans l'ordre où elles
ont été spécifiés sur la ligne de commande.

-r, --exiger BIBLIOTHÈQUE
nécessitent une BIBLIOTHÈQUE spécifiée avant d'exécuter l'application. Le "exiger"
seront exécutées immédiatement et dans l'ordre dans lequel elles ont été spécifiées sur le
ligne de commande.

SIGNAUX

Les signaux UNIX suivants peuvent être envoyés au processus maître :

· HUP - rechargez le fichier de configuration, l'application et redémarrez gracieusement tous les travailleurs

· INT/TERM - arrêt rapide, tue tous les travailleurs immédiatement

· QUIT - arrêt gracieux, attend que les travailleurs terminent leur demande en cours avant
finition.

· USR1 - rouvrir tous les journaux appartenant au maître et à tous les travailleurs Voir Unicorn::Util.reopen_logs
pour ce qui est considéré comme un journal.

· USR2 - réexécute le binaire en cours d'exécution. Un QUIT séparé doit être envoyé à l'original
processus une fois que l'enfant est vérifié pour être opérationnel.

· TREUIL - arrête gracieusement les travailleurs mais maintient le maître en marche. Cela ne fonctionnera que pour
processus démonisés.

· TTIN - incrémente le nombre de processus de travail d'un

· TTOU - décrémentez le nombre de processus de travail d'un

Voir les SIGNAUX (http://unicorn.bogomips.org/SIGNALS.html) document pour une description complète
de tous les signaux utilisés par Unicorn.

RACK ENVIRONNEMENT

Les valeurs acceptées de RACK_ENV et du middleware qu'ils chargent automatiquement (en dehors de
RACKUP_FILE) sont exactement comme ceux de accumuler(1):

· développement - charge Rack::CommonLogger, Rack::ShowExceptions et Rack::Lint middleware

· déploiement - charge le middleware Rack::CommonLogger

· aucun - ne charge aucun middleware, s'appuyant entièrement sur RACKUP_FILE

Toutes les valeurs non reconnues pour RACK_ENV sont supposées être « aucune ». Les déploiements de production sont
il est fortement recommandé d'utiliser « déploiement » ou « aucun » pour des performances maximales.

À partir de Unicorn 0.94.0, RACK_ENV est également exporté en tant que variable d'environnement à l'échelle du processus.
Bien qu'il ne fasse pas partie de la spécification Rack à partir de Rack 1.0.1, cela est devenu un
standard de fait dans le monde du Rack.

Notez que les middlewares Rack::ContentLength et Rack::Chunked sont également chargés par « déploiement »
et « développement », mais aucune autre valeur de RACK_ENV. Si nécessaire, elles doivent être définies individuellement.
spécifiés dans le RACKUP_FILE, certains frameworks ne les nécessitent pas.

ENVIRONNEMENT VARIABLES

La variable RACK_ENV est définie par le commutateur -E mentionné précédemment. Toutes les applications ou bibliothèques
des variables d'environnement spécifiques (par exemple TMPDIR) peuvent toujours être définies dans le CONFIG_FILE Unicorn
en plus de la coquille d'apparition. Lors de l'amélioration transparente de la Licorne, tout l'environnement
Les variables définies dans l'ancien processus maître sont héritées par le nouveau processus maître. Unicorn
utilise uniquement (et écrasera) la variable d'environnement UNICORN_FD en interne lors de l'exécution
mises à niveau transparentes.

UNICORN_FD est une liste délimitée par des virgules d'un ou plusieurs descripteurs de fichiers utilisés pour implémenter
Mises à niveau USR2. Les systèmes d'initialisation peuvent se lier aux sockets d'écoute et générer des licornes avec
UNICORN_FD est défini sur les numéros de descripteur de fichier des sockets d'écoute. La licorne
CONFIG_FILE doit toujours avoir les paramètres de socket d'écoute hérités définis comme dans un fichier normal
démarrage, sinon le socket sera fermé.

Utilisez Unicorn en ligne avec les services onworks.net