Whenever you “do something” some other things somewhere usually knows about it. This affords us the chance to hook into that event – and fire off any other number of events or processes.
DeployBot is a way to configure these events and “deploy” your code to a server automatically.
Ask to be added as a user in the DeployBot system
You can just ask us in the chatroom etc.
Make sure we get the email you use on Github specifically.
Then we’ll log into DeployBot – and create a user for you. Get together with Derek and walk through this – and help us flesh it out!!
(Someone on staff will log into DeployBot, users, invite user, opens form, input full-name, input email)
(also – everyone is an admin – so anyone who’s already setup – could add you)
(That email would likely need to be the GitHub one, right?)
(Make sure they are checked as Admin or they can’t add their own repos)
Check your email (in your desktop web browser)
You’ll have an email: Please complete your account login.
There will be a link below. Follow that link.
It will open up in a new tab/browser window
There will be a weird warning: “Did you mean Perpetual Education?”
No. You did not. It’s confusing. You want to follow the DeployBot link. It’s trying to alert you that this looks fishy, but it’s not fishy. (We’ve talked to them about this). So, click “ignore.” (they might have fixed this – let us know if you see it)
You’ll be directed and asked to “complete your profile” to join the DeployBot Account.
Choose a password and create your account.
Log in to DeployBot
You’ll be directed to a login form.
Enter your email and your password and login.
Arrive at the main dashboard
You’ll be logged in and directed to the dashboard.
You’re here! What are we doing again?
The goal: To connect our GitHub repo and set it up so that when we push our changes to that repo – DeployBot automatically takes that code and sends it to the PE server with FTP.
The goal: To get our website files (that we’ve been writing locally) (and that also pushed up to GitHub) pushed up to the PE server. So – whatever repository that is, right?
Traditionally, students often name their local folder
pe-projectsand that is where they’ve initialized a local Git repo. That is the folder being tracked. THEN they have a repository named
pe-projectsup in the Cloud on Github. (so the names match – and it’s easier to understand what is connected to what)
But some of you – might not have created a repo for this yet. In that case, you need to create a new repository. You could name it
portfolioor whatever you think is most descriptive and useful.
So, – figure out what is going on. Do you have a repo you want to add/connect to this DeployBot system?
Choose a repository
Get the URL of the GitHub repo that you want to connect. On the GitHub page for the repo, there is a stupid green button/dropdown thing that says “code” – so, obviously – that’s where it is – right? Thanks, Microsoft!
Copy it to your clipboard.
Connect your repo to DeployBot
Go back to the DeployBot dashboard and see where you can add a repo.
Does anything seem like a good thing to click? What are the top-level choices?
“Dashboard” (we’re already there)
“Repositories” (seems pretty good!)
Hint: It’s repositories.
Click that link.
You’ll land on the repositories page.
There will be a list of all of the repositories – and at the top of that list – is a button that says “Add Repository.”
You’re now given a choice of cloud Git services. There are many different companies that do this stuff. GitHub is the most famous. And – it’s the one we’re using. So – choose GitHub? Nope. Don’t. Choose “other.”
(whoever built this didn’t consider that many people may have the same GitHub repos – and for some reason / it only allows one repo of each name if you choose GitHub / so,
personal-websitewill be blocked – if someone already has a repo called that. Strange / but OK.)
Add your information in there – and connect the repo. (anything interesting about this / SSH vs – ).. ??
Great. You have a repo locally – and in the cloud. They are connected to each other. Now you have a username and login to DeployBot and you’ve given DeployBot permissions to connect to the GitHub repository. But now what?
Give DeployBot directions to connect to the FTP server
“Create enironment and server”
“Name” ?? PE Project Server
Add new FTP server
Name it /// (another name?) … uh…
yourFolderName(whatever your folder is called on the server)
password: (your FTP password / which you likely don’t remember / and transmit won’t show you – so, ask us to reset it.
should see “connection established”
Now set up the webhook in Github
repo > settings > webhooks > add webhook (it’ll ask for a “payload URL”
get refresh URL in deploy bot — (Set it to JSON?)