zzugab/juice-shop-with-kubeadm-and-tfDéploiement automatisé de OWASP Juice Shop sur Kubernetes en utilisant kubeadm et Terraform, avec scan de vulnérabilité Trivy intégré pour les pipelines DevSecOps.
Pour vous faciliter la prise en main avec GitLab, voici une liste d'étapes recommandées.
Déjà un expert ? Modifiez simplement ce README.md et personnalisez-le. Vous voulez simplifier ? Utilisez le modèle en bas !
cd existing_repo
git remote add origin https://gitlab.com/zzugab/juice-shop-with-kubeadm-and-tf.git
git branch -M main
git push -uf origin main
Utilisez l'intégration continue intégrée dans GitLab.
Lorsque vous êtes prêt à personnaliser ce README, modifiez simplement ce fichier et utilisez le modèle pratique ci-dessous (ou n'hésitez pas à le structurer comme vous le souhaitez - ce n'est qu'un point de départ !). Merci à makeareadme.com pour ce modèle.
Chaque projet est différent, alors réfléchissez aux sections qui s'appliquent au vôtre. Les sections utilisées dans le modèle sont des suggestions pour la plupart des projets open source. Gardez également à l'esprit qu'un README peut être trop long et détaillé, mais mieux vaut trop long que trop court. Si vous pensez que votre README est trop long, envisagez d'utiliser une autre forme de documentation plutôt que de couper des informations.
Choisissez un nom explicite pour votre projet.
Faites savoir aux gens ce que votre projet peut faire spécifiquement. Fournissez du contexte et ajoutez un lien vers toute référence que les visiteurs pourraient ne pas connaître. Une liste de fonctionnalités ou une sous-section Contexte peut également être ajoutée ici. S'il existe des alternatives à votre projet, c'est un bon endroit pour lister les facteurs de différenciation.
Sur certains README, vous pouvez voir de petites images qui transmettent des métadonnées, comme par exemple si tous les tests réussissent pour le projet. Vous pouvez utiliser Shields pour en ajouter à votre README. De nombreux services ont également des instructions pour ajouter un badge.
Selon ce que vous réalisez, il peut être judicieux d'inclure des captures d'écran ou même une vidéo (vous verrez souvent des GIF plutôt que des vidéos réelles). Des outils comme ttygif peuvent aider, mais regardez Asciinema pour une méthode plus sophistiquée.
Dans un écosystème particulier, il peut y avoir une manière courante d'installer des choses, comme utiliser Yarn, NuGet ou Homebrew. Cependant, considérez la possibilité que la personne lisant votre README soit novice et préfère des conseils plus précis. Lister des étapes spécifiques aide à lever l'ambiguïté et permet aux gens d'utiliser votre projet aussi rapidement que possible. S'il ne fonctionne que dans un contexte spécifique comme une version particulière de langage de programmation ou un système d'exploitation, ou s'il a des dépendances qui doivent être installées manuellement, ajoutez également une sous-section Exigences.
Utilisez des exemples librement, et montrez le résultat attendu si possible. Il est utile d'avoir en ligne le plus petit exemple d'utilisation que vous pouvez démontrer, tout en fournissant des liens vers des exemples plus sophistiqués s'ils sont trop longs pour être inclus raisonnablement dans le README.
Dites aux gens où ils peuvent aller pour obtenir de l'aide. Cela peut être n'importe quelle combinaison d'un tracker de problèmes, d'un salon de discussion, d'une adresse e-mail, etc.
Si vous avez des idées pour des versions futures, c'est une bonne idée de les lister dans le README.
Indiquez si vous êtes ouvert aux contributions et quelles sont vos exigences pour les accepter.
Pour les personnes qui souhaitent apporter des modifications à votre projet, il est utile d'avoir une documentation sur la façon de commencer. Il y a peut-être un script qu'elles devraient exécuter ou des variables d'environnement à définir. Rendez ces étapes explicites. Ces instructions pourraient également être utiles à votre futur vous-même.
Vous pouvez également documenter les commandes pour linter le code ou exécuter les tests. Ces étapes aident à garantir une qualité de code élevée et réduisent la probabilité que les changements cassent accidentellement quelque chose. Avoir des instructions pour exécuter les tests est particulièrement utile si cela nécessite une configuration externe, comme le démarrage d'un serveur Selenium pour tester dans un navigateur.
Montrez votre reconnaissance à ceux qui ont contribué au projet.
Pour les projets open source, dites comment il est licencié.
Si vous manquez d'énergie ou de temps pour votre projet, mettez une note en haut du README indiquant que le développement a ralenti ou s'est complètement arrêté. Quelqu'un pourrait choisir de forker votre projet ou de se porter volontaire en tant que mainteneur ou propriétaire, permettant ainsi à votre projet de continuer. Vous pouvez également faire une demande explicite de mainteneurs.