Forge Boot Camp Prep Instructions
Daily schedule
Please consult the class listing to confirm the times for your class. We typically schedule either three days of eight hours, or four days of six hours.
Please confirm the time zone of your class hours. It is easy to misread the time zone and arrive early or late.
Each day we will take a 1 hour break for lunch, at approximately 12:00pm in the class-listed time zone.
Student computer setup checklist
To prepare, please work through this checklist.
1. Computer
We recommend that students prepare their computer prior to attending. During class, the instructor(s) will help with any remaining setup problems, but this takes time that could otherwise be spent in the class.
2. Connectivity
Because the online class uses a video and audio feed, please ensure your network connection is robust and that you have good bandwidth available. Use any common speed test tool like fast.com.
This usually works "out of the box" for personal computers and home networks, but corporate computers and networks sometimes are locked-down in ways that require IT assistance.
3. Web browser
Please install Google Chrome for use in class.
4. Online meeting system
We usually use Microsoft Teams for the online meeting mechanism.
Please test your computer and network connectivity before class, using the same computer and network you plan to use during class.
When joining the online classroom you will be prompted to enter your name. Please enter the same name you used in your registration for the class, so that we can confirm which students have successfully arrived. Do not leave the name blank.
5. Headset, or speakers and microphone
Although online students often ask questions and get answers via text chat, complex questions are more easily asked via voice audio. Students who may want to participate in this way should ensure they have reasonable audio hardware. A headset with microphone tends to provide clear, feedback-free audio when asking a question. Video is also welcome for attendees asking questions.
6. Time zone
Although not strictly a computer readiness matter, we recommend that students carefully double check their time zone versus the time zone of the class. It is somewhat common for a student to unexpectedly find the class started an hour earlier or later than they thought. Our courses are generally taught in US Central time zone.
Requirements
Install Node (which includes NPM)
Node.js is a JavaScript runtime that is used by Atlassian Forge. Please download and install Node.js from [the Node.js web site](https://nodejs.org). The Node.js installer also includes NPM. We recommend installing the LTS (Long Term Support) version of Node.js.
Linux users: We recommend you install Node.js using your package manager or using a tool like [NVM](https://github.com/creationix/nvm).
Install Forge/CLI Globally
Take this opportunity to install forge on your machine so it can be used throughout the course.
npm i @forge/cli -g
- Validate that forge is installed by doing a command like `forge create --help` for each student.
Create A Atlassian User Token
Go to Forge Token Creator
**DON'T SHARE THIS WITH ANYONE!!!**
This is like your user account's password. If someone gets this, they can do whatever it is they want.
Here is an example of a fake token:
ATATT3xFfGF0x_K9qMGYwVbHpGrT53f1uRSD89Ln6j8KTLTsgHSYkxWuP_TyLSErjkQThVeixOP8-84MyB22PxDWQ-nYX1yilO0VrQVgJMNL_oOdpQs7ptTL8crTqP6xufoYy5CEzrJKUVqn96XtxMYmhHsRtPgGJmZzSD4y46-Rw7Ye-pj-E-a=901A33F8
Once you have your token go ahead and login to the CLI
forge login
- It will ask for your email. Make sure it's the email you created the token with. Enter it for example: zishan.aslam@valiantys.com
- It will then ask for your token. Paste in your token you created above.
Nice! You should be logged in. If you are not, please ask the instructor for help.
To validate that you are logged in, type
forge whoami
Install Postman
Please download and install Postman. We will be using this a lot throughout the course to test/debug our forge apps.
Create a developer site
1. Go to http://go.atlassian.com/cloud-dev and create a site using the email address associated with your Atlassian account.
2. Once your site is ready, log in and complete the setup wizard.