cadence

Cadence

Ce référentiel contient le code source du serveur Cadence et d'autres outils, notamment CLI, outils de schéma, Bench et Canary.

Vous pouvez implémenter vos workflows avec l'une de nos bibliothèques clientes. Les bibliothèques Go et Java sont officiellement maintenues par l'équipe Cadence, tandis que les bibliothèques clientes Python et Ruby sont développées par la communauté.

Vous pouvez également utiliser iWF comme framework DSL au-dessus de Cadence.

Voir la conférence de Maxim à la conférence Data@Scale pour un aperçu architectural de Cadence.

Visitez cadenceworkflow.io pour en savoir plus sur Cadence. Rejoignez-nous dans le projet de documentation Cadence. N'hésitez pas à y soulever un problème ou une demande de tirage.

Communauté

• Discussion sur GitHub
  • Idéal pour les questions et réponses, le support/aide, les discussions générales et les annonces
• StackOverflow
  • Idéal pour les questions et réponses et la discussion générale
• Problèmes GitHub
  • Idéal pour signaler des bugs et des demandes de fonctionnalités
• Mou
  • Idéal pour les discussions de contribution/développement

Commencer

Démarrez le serveur de cadence

Pour exécuter les services Cadence localement, nous vous recommandons fortement d'utiliser le docker de service Cadence pour exécuter le service. Vous pouvez également suivre les instructions pour le créer et l’exécuter.

Veuillez visiter notre site de documentation pour la configuration de la production/du cluster.

Exécuter les exemples

Essayez les exemples de recettes pour Go ou Java pour commencer.

Utiliser la CLI Cadence

Cadence CLI peut être utilisée pour faire fonctionner les flux de travail, la liste de tâches, le domaine et même les clusters.

Vous pouvez utiliser les méthodes suivantes pour installer Cadence CLI :

• Utilisez Brew pour installer la CLI : brew install cadence-workflow
  • Suivez les instructions si vous devez installer des anciennes versions de CLI via homebrew. Cela n'est généralement nécessaire que lorsque vous utilisez un serveur dont la version est trop ancienne.
• Utilisez l'image docker pour CLI : docker run --rm ubercadence/cli:<releaseVersion> ou docker run --rm ubercadence/cli:master . Assurez-vous de mettre à jour votre image lorsque vous souhaitez essayer de nouvelles fonctionnalités : docker pull ubercadence/cli:master
• Créez vous-même le binaire CLI, consultez le dépôt et exécutez make cadence pour créer tous les outils. Voir CONTRIBUTION pour les prérequis de la commande make.
• Créez vous-même l'image CLI, voir les instructions

Cadence CLI est un outil puissant. Les commandes sont organisées par onglets . Par exemple workflow -> batch -> start , ou admin -> workflow -> describe .

Veuillez lire la documentation et essayez toujours --help sur n'importe quel onglet pour apprendre et explorer.

Utiliser CadenceWeb

Essayez Cadence Web UI pour afficher vos flux de travail sur Cadence. (Ceci est déjà disponible sur localhost:8088 si vous exécutez Cadence avec docker compose)

Contribuer

Nous serions ravis de votre aide pour rendre Cadence géniale. Veuillez consulter notre guide de contribution.

Si vous souhaitez proposer une nouvelle fonctionnalité, rejoignez d'abord la chaîne Slack pour démarrer une discussion et vérifier s'il existe des discussions de conception existantes. Consultez également nos documents de conception au cas où une fonctionnalité aurait été conçue mais pas encore implémentée. Une fois que vous êtes sûr que la proposition n’est pas couverte ailleurs, veuillez suivre nos instructions de proposition.

Autres binaires dans ce dépôt

Outils de workflow de tests de banc/stress

Voir la documentation du banc.

Outils de flux de travail de vérification périodique de l'état des fonctionnalités (alias Canary)

Voir la documentation Canary.

Outils de schéma pour SQL et Cassandra

Les outils sont destinés à la configuration manuelle ou à la mise à niveau du schéma de base de données

• Si le serveur fonctionne avec Cassandra, utilisez l'outil Cadence Cassandra
• Si le serveur fonctionne avec une base de données SQL, utilisez l'outil Cadence SQL

Le moyen le plus simple d’obtenir l’outil de schéma est via homebrew.

brew install cadence-workflow inclut également cadence-sql-tool et cadence-cassandra-tool .

• Les fichiers de schéma se trouvent dans /usr/local/etc/cadence/schema/ .
• Pour mettre à niveau, assurez-vous d'abord de supprimer l'ancien schéma ElasticSearch : mv /usr/local/etc/cadence/schema/elasticsearch /usr/local/etc/cadence/schema/elasticsearch.old && brew upgrade cadence-workflow . Sinon, les schémas ElasticSearch risquent de ne pas pouvoir être mis à jour.
• Suivez les instructions si vous devez installer d'anciennes versions d'outils de schéma via homebrew. Cependant, un moyen plus simple consiste à utiliser les nouvelles versions des outils de schéma avec les anciennes versions des schémas. Tout ce dont vous avez besoin est de consulter l'ancienne version des schémas de ce référentiel. Exécutez git checkout v0.21.3 pour obtenir les schémas v0.21.3 dans le dossier de schéma.

Les astronomes au fil du temps

Licence

Licence MIT, veuillez consulter LICENCE pour plus de détails.