Frequently Asked Questions
Questions that many might frequently have:
What does the Reclass Infrastructure look like?
The Infrastructure for project reclass is hosted on AWS. This infrastructure hosts the main website: projectreclass.org as well as the main product at: toynet.projectreclass.org
All of the instances, networking, and services are built out with Terraform the only resources not built via Terraform are the route53 dns entries - the majority of which are and must be managed manually.
While the main website is a simple wordpress site hosted on an EC2 instance and named with an A record on Route53; the toynet infrastructure is a bit more complex this diagram presents a graphical representation of the toynet infrastructure.
The above is a basic represnetation of the toynet infrastructure, it does not include smaller details such as subnets, availability zones, how access is managed, etc.
What is toynet built on?
Toynet is built on top of the mininet technology. The toynet application lives in a docker container and is deployed in an EC2 instance via docker-compose.
How can I push my Terraform code to AWS?
In order to create resources on AWS you will need a vaild access key on your machine, Terraform will automatically read these keys for you as long as your enter them when you run aws configure
The above illustrates the default for an AWS configure, our default region is ohio or us-east-2 and our default output format is json.
Additionally, you'll see the last 4 characters correspond to an AWS Access Key ID and an AWS Secret Access Key yours will be different.
How do I obtain an AWS Access Key?
In order to obtain an AWS access key you'll need an AWS account, access keys can be managed in the IAM section of AWS. Ensure you save the file or store your access keys in a safe place as they will only be viewable simultaneously, once.
Need help logging into a server?
SSH credentials are managed by via AWS OpsWorks, this will allow each user to specify their public key, and utilize their own private key to access each server in a stack!
Ensure the server you're attempting to access is in the stack, your user has the public key uploaded, and that the target operating system is a supported distro
Further, ensure your user has proper Instance Access
Accessing these docs
This is the official documentation page for Project Reclass. These docs can be accessed via docs.projectreclass.org or they can be accessed via the gitbooks slack integration. First ensure that the desired space has the integration enabled, this is in the documents section for each space and correleates to the overall space such as the infrastructure or home page.
Once the space has been enabled and added to a primary channel - this is for gitbook admin alerts - you can access these docs from any channel in the slack organization.
To do this simply run /gitbook [search query] this will send a message to everyone in the channel with the results. You can also do this in private messages, even with yourself.
Last updated
