code_deploy
le pogobot a besoin d'être relié à du code pour pouvir fonctionner. Nous verrons dans cette partie comment creer un compte de deploiement distant avec Horeku et copier le code depuis un répository github.
Si vous êtes en train de lire ce wiki c'est que vous avez atteint la page de github. Si ce n'est pas déjà le cas je vous invite à creer un compte utilisateur sur github selectionnez tout ce qui est gratuit est décrivez rapidement votre niveau en informatique
Une fois votre compte crée rejoignez mon repository
si mon travail vous plait je vous invite à ajouter une "star" (en haut à droite), c'est un peu le pousse bleu des geek
en haut à gauche vous trouverez un bouton fork
vous avez du être rediriger vers une page tout à fait similaire mais dont le repository a changé de nom :
au lieu de 12rambau/pogoBot vous êtes désormais sur [votre_nom_de_repo]/poGoBot. Pour les curieux vous avez maintenant une copie personnel (puisque c'est sur votre répo) de mon travail. Elle pourra être mise à jour en cas de nouvelle version.
Heroku est une plateforme de virtualisation qui va nous permettre de faire tourner notre bot quasiment toute la journée sans avoir à nous soucier de l'alimentation ou du fonctionnement d'un ordinateur personnel. commencez par vous creer un compte sur le site officel d'Heroku
si vous avez déjà un serveur et que vous compté lancé le bot python directement pas besoin de tenir compte des indications sur heroku
nous boilà donc sur la page de lancement d'heroku
Ce coup ci je vous ai pas mis les fleches rouges mais c'est évident nous allons creer une application python. cliquez donc sur python puis sur create new app
donnez lui le nom que vous voulez ça n'a pas d'importance.
assurez vous de rester sur la bonne zone (europe/US)
vous atterissez normalement sur une page de ce type
dans deployement method choisissez GitHub et realisez les operations de connection (connect to github -> authorized Github)
dans connect to github trouvez et selectionnez le nom du repository que nous avons crée dans la section précédente.
.
passez ensuite à la tuile suivante et selectionnez la branch release pour realiser votre deployment automatique.
Pour le premier deploieemnt utilser le déploiement manuel mais toujours su la branch release
sous la fenetre précédente va s'ouvrir un invite de commande qui va installer tutes les dépendances liées à notre projet et effectuer les verifications d'usage. si tout se passe comme prevu vous app doit être déployer sans encombre (si ce n'est pas le cas, merci de le rapporter sur les issues du projet en décrivant aussi fidelement que possible les operations qui vous ont mené à ce bug)
pour interagir avec vos utilisateurs, le code doit savoir quel bot lancer et sur quel server il se trouve.
c'est la clef qui permet au code de connaitre l'identité du bot
retournez dans la liste des app discord puis dans votre app. dans la tuile bot cliquez sur "reveale token"
⚠️ ce token doit toujours restez secret. si d'aventure un tier en prend connaissance vous pouvez le change en cliquant sur generate new token.
il faudra ensuite le changer sur heroku
copier la clef. retourner sur heroku puis dans les settings de votre app. DAns ces settings cliquez sur reveal config var et entrez votre token dans une variable d'environement que vous nomerez DISCORD_TOKEN
Pour communiquer avec notre server PoGoBot a besoin de connaitre son Id
retourner sur Discord et fait un clique droit sur le nom de votre salon et cliquer sur copier id
si vous n'obtenez pas le menu
copier l'idaller dans les paramettres de votre profil (tout en bas à gauche) et dans apparence activez le mode utilisateur
cette clef est à rajouter comme la préscedente dans une variable d'environement : DISCORD_SERVER_ID
dans heroku cliquer sur le menu overview de votre app. Normalement la tuile dyno formationvous indique que votre app n'a pas démarré, les dyno sont sur off.
Pour la faire démarer cliquez sur configure Dynos et dans free dynos editer botpour le lancer sur 1 dyno
puis cliquez sur confirm
rdv dans la page d'accueil de votre server discord puis dans le salon #general
tapez la commande !cookieet le bot devrait vous répondre
voilà le bot est parfaitement operationnel et online
Pour de plus ample renseignement sur la gestion de l'horloge des dynos (vous ne pourrez pas le laisser allumer toute la journée tous les jours, le plus simple est de le couper pendant la nuit) je vous invite à lire cette page
pour continuer de découvrir les fonctionnalité du bot vous pouvez vous rendre sur la doc utilisateur