This project focuses on the deployment of static content using Nginx and automating this process with Fabric scripts. The goal is to deepen understanding of web server configuration, file distribution, and automation of deployment tasks.
This project is part of the larger AirBnB clone project. In this segment, we prepare web servers to deploy static content, create a Fabric script to generate a .tgz archive from the contents of the web_static folder, and write scripts to distribute this archive and deploy it on web servers.
- Ubuntu 20.04 LTS
- Python 3.4.0
- Fabric 3 version 1.14.post1
- Nginx installed on the web servers
- Clone this repository:
git clone [repository-url] - Ensure you have the required permissions to execute the scripts.
-
Prepare your web servers:
Execute the script to configure Nginx and prepare the directories for deployment.
This repository contains the advanced stage of a student project to build a clone of the AirBnB website. This version extends the initial backend interface, or console, to manage program data with enhanced functionality. The console commands now allow the user to interact with a MySQL database, creating, updating, and destroying objects, and managing database storage. This version introduces Object-Relational Mapping (ORM) using SQLAlchemy, adding a layer of abstraction to interact with the database.
| Tasks | Files | Description |
|---|---|---|
| 0: Authors/README File | AUTHORS | Project authors |
| 1: Pep8 | N/A | All code is pep8 compliant |
| 2: Unit Testing | /tests | Unit tests for all class-defining modules |
| 3-10: Various | /models/*, console.py | Expansion of model classes and console functionality to include database interaction using SQLAlchemy |
| Additional: MySQL setup | /setup_mysql_dev.sql, /setup_mysql_test.sql | Scripts to prepare the MySQL database for development and testing environments |
First, clone this repository to your local machine.
```bash git clone [repository link] ```
Navigate to the repository directory and run `console.py`:
```bash cd AirBnB_clone_v2 ./console.py ```
This command launches the HBNB console. From here, you can use various commands to interact with the system.
The console supports the following commands, enhanced to interact with the MySQL database:
- `create`: Creates an instance based on the given class.
- `destroy`: Destroys an object based on class name and ID.
- `show`: Shows an object based on class name and ID.
- `all`: Shows all objects, or all objects of a given class.
- `update`: Updates an object's attributes based on class name and ID.
- `quit`: Exits the console (EOF also exits).
The console supports an alternative syntax for some commands:
```bash <class_name>.([ [<attribute_name> <attribute_value>] | [<dictionary_representation>]]) ```
- Integration with MySQL database using SQLAlchemy.
- Enhanced storage engine to switch between file storage and database storage.
- Extended model classes and console commands to interact with the database.
- Scripts to set up and configure the MySQL database for development and testing environments.
Ensure MySQL is installed and running. Set the necessary environment variables (`HBNB_MYSQL_USER`, `HBNB_MYSQL_PWD`, `HBNB_MYSQL_HOST`, `HBNB_MYSQL_DB`, and `HBNB_TYPE_STORAGE`) to configure the connection to the MySQL database.
Contributions to this project are welcome. Please follow the standard fork, clone, edit, and pull request workflow.
This repository contains the initial stage of a student project to build a clone of the AirBnB website. This stage implements a backend interface, or console, to manage program data. Console commands allow the user to create, update, and destroy objects, as well as manage file storage. Using a system of JSON serialization/deserialization, storage is persistent between sessions.
| Tasks | Files | Description |
|---|---|---|
| 0: Authors/README File | AUTHORS | Project authors |
| 1: Pep8 | N/A | All code is pep8 compliant |
| 2: Unit Testing | /tests | All class-defining modules are unittested |
| 3. Make BaseModel | /models/base_model.py | Defines a parent class to be inherited by all model classes |
| 4. Update BaseModel w/ kwargs | /models/base_model.py | Add functionality to recreate an instance of a class from a dictionary representation |
| 5. Create FileStorage class | /models/engine/file_storage.py /models/_ init _.py /models/base_model.py | Defines a class to manage persistent file storage system |
| 6. Console 0.0.1 | console.py | Add basic functionality to console program, allowing it to quit, handle empty lines and ^D |
| 7. Console 0.1 | console.py | Update the console with methods allowing the user to create, destroy, show, and update stored data |
| 8. Create User class | console.py /models/engine/file_storage.py /models/user.py | Dynamically implements a user class |
| 9. More Classes | /models/user.py /models/place.py /models/city.py /models/amenity.py /models/state.py /models/review.py | Dynamically implements more classes |
| 10. Console 1.0 | console.py /models/engine/file_storage.py | Update the console and file storage system to work dynamically with all classes update file storage |
-
First clone this repository.
-
Once the repository is cloned locate the "console.py" file and run it as follows:
/AirBnB_clone$ ./console.py
- When this command is run the following prompt should appear:
(hbnb)
- This prompt designates you are in the "HBnB" console. There are a variety of commands available within the console program.
* create - Creates an instance based on given class
* destroy - Destroys an object based on class and UUID
* show - Shows an object based on class and UUID
* all - Shows all objects the program has access to, or all objects of a given class
* update - Updates existing attributes an object based on class name and UUID
* quit - Exits the program (EOF will as well)
Users are able to issue a number of console command using an alternative syntax:
Usage: <class_name>.<command>([<id>[name_arg value_arg]|[kwargs]])
Advanced syntax is implemented for the following commands:
* all - Shows all objects the program has access to, or all objects of a given class
* count - Return number of object instances by class
* show - Shows an object based on class and UUID
* destroy - Destroys an object based on class and UUID
* update - Updates existing attributes an object based on class name and UUID
Usage: create <class_name>
(hbnb) create BaseModel
(hbnb) create BaseModel
3aa5babc-efb6-4041-bfe9-3cc9727588f8
(hbnb)
Usage: show <class_name> <_id>
(hbnb) show BaseModel 3aa5babc-efb6-4041-bfe9-3cc9727588f8
[BaseModel] (3aa5babc-efb6-4041-bfe9-3cc9727588f8) {'id': '3aa5babc-efb6-4041-bfe9-3cc9727588f8', 'created_at': datetime.datetime(2020, 2, 18, 14, 21, 12, 96959),
'updated_at': datetime.datetime(2020, 2, 18, 14, 21, 12, 96971)}
(hbnb)
Usage: destroy <class_name> <_id>
(hbnb) destroy BaseModel 3aa5babc-efb6-4041-bfe9-3cc9727588f8
(hbnb) show BaseModel 3aa5babc-efb6-4041-bfe9-3cc9727588f8
** no instance found **
(hbnb)
Usage: update <class_name> <_id>
(hbnb) update BaseModel b405fc64-9724-498f-b405-e4071c3d857f first_name "person"
(hbnb) show BaseModel b405fc64-9724-498f-b405-e4071c3d857f
[BaseModel] (b405fc64-9724-498f-b405-e4071c3d857f) {'id': 'b405fc64-9724-498f-b405-e4071c3d857f', 'created_at': datetime.datetime(2020, 2, 18, 14, 33, 45, 729889),
'updated_at': datetime.datetime(2020, 2, 18, 14, 33, 45, 729907), 'first_name': 'person'}
(hbnb)
Usage: <class_name>.all()
(hbnb) User.all()
["[User] (99f45908-1d17-46d1-9dd2-b7571128115b) {'updated_at': datetime.datetime(2020, 2, 19, 21, 47, 34, 92071), 'id': '99f45908-1d17-46d1-9dd2-b7571128115b', 'created_at': datetime.datetime(2020, 2, 19, 21, 47, 34, 92056)}", "[User] (98bea5de-9cb0-4d78-8a9d-c4de03521c30) {'updated_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134362), 'id': '98bea5de-9cb0-4d78-8a9d-c4de03521c30', 'created_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134343)}"]
Usage: <class_name>.destroy(<_id>)
(hbnb) User.destroy("99f45908-1d17-46d1-9dd2-b7571128115b")
(hbnb)
(hbnb) User.all()
(hbnb) ["[User] (98bea5de-9cb0-4d78-8a9d-c4de03521c30) {'updated_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134362), 'id': '98bea5de-9cb0-4d78-8a9d-c4de03521c30', 'created_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134343)}"]
Usage: <class_name>.update(<_id>, <attribute_name>, <attribute_value>)
(hbnb) User.update("98bea5de-9cb0-4d78-8a9d-c4de03521c30", name "Todd the Toad")
(hbnb)
(hbnb) User.all()
(hbnb) ["[User] (98bea5de-9cb0-4d78-8a9d-c4de03521c30) {'updated_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134362), 'id': '98bea5de-9cb0-4d78-8a9d-c4de03521c30', 'name': 'Todd the Toad', 'created_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134343)}"]
Usage: <class_name>.update(<_id>, )
(hbnb) User.update("98bea5de-9cb0-4d78-8a9d-c4de03521c30", {'name': 'Fred the Frog', 'age': 9})
(hbnb)
(hbnb) User.all()
(hbnb) ["[User] (98bea5de-9cb0-4d78-8a9d-c4de03521c30) {'updated_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134362), 'name': 'Fred the Frog', 'age': 9, 'id': '98bea5de-9cb0-4d78-8a9d-c4de03521c30', 'created_at': datetime.datetime(2020, 2, 19, 21, 47, 29, 134343)}"]