Agile611/startusingdocker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added new README

Browse Source
This commit is contained in:
Guillem Hernandez Sola
2025-04-22 09:55:39 +02:00
parent 2ab36d248d
commit c18520b024
6 changed files with 0 additions and 133 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
.idea/.gitignore generated vendored
View File

@@ -1,3 +0,0 @@
# Default ignored files
/shelf/
/workspace.xml

6
.idea/misc.xml generated
View File

@@ -1,6 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="ProjectRootManager" version="2" languageLevel="JDK_X" default="true" project-jdk-name="22" project-jdk-type="JavaSDK">
<output url="file://$PROJECT_DIR$/out" />
</component>
</project>

8
.idea/modules.xml generated
View File

@@ -1,8 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="ProjectModuleManager">
<modules>
<module fileurl="file://$PROJECT_DIR$/.idea/startusingdocker.iml" filepath="$PROJECT_DIR$/.idea/startusingdocker.iml" />
</modules>
</component>
</project>

9
.idea/startusingdocker.iml generated
View File

@@ -1,9 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<module type="JAVA_MODULE" version="4">
<component name="NewModuleRootManager" inherit-compiler-output="true">
<exclude-output />
<content url="file://$MODULE_DIR$" />
<orderEntry type="inheritedJdk" />
<orderEntry type="sourceFolder" forTests="false" />
</component>
</module>

6
.idea/vcs.xml generated
View File

@@ -1,6 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<project version="4">
<component name="VcsDirectoryMappings">
<mapping directory="" vcs="Git" />
</component>
</project>

101
compose/README.md
View File

@@ -1,101 +0,0 @@
[![Agile611](https://www.agile611.com/wp-content/uploads/2020/09/cropped-logo-header.png)](http://www.agile611.com/)
# Start Using Docker
Here is an explanation of the architecture to be used in the training.
This is an academic setup; it is not intended to be a production environment.
## Working Repository
Attached is the work repository we will use during the course:
[Start Using Docker](https://bitbucket.org/agile611/startusingdocker)
For the training sessions, computers will be needed, either laptops or desktops.
## Installation for Local Development
We need to install these 3 applications on our machines:
- [GIT](https://git-scm.com/downloads)
- [Vagrant](https://www.vagrantup.com/downloads.html)
- [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
Vagrant fetches virtual machines from remote repositories, so we advise disconnecting any VPN connections on your machine.
### Setting Up the Environment
To download the repository, you need to download the code:
```shell
git clone https://bitbucket.org/agile611/startusingdocker.git
cd startusingdocker
```
From the folder `startusingdocker`, use the following command to set up an Ubuntu 24.04 VM (from now on, the Box):
```shell
vagrant up
```
Then, to access the Box, connect via SSH using the following command:
```shell
vagrant ssh
```
### Potential Problems Provisioning the Box
If you have problems provisioning the Box, you can download it directly from [here](https://portal.cloud.hashicorp.com/vagrant/discover/bento/ubuntu-24.04) depending on your architecture.
Then, you need to know the path of the Box and execute the following commands:
```shell
vagrant box add /The/Path/From/Your/Downloaded/box/bento-ubuntu-24-04.box --name bento/ubuntu-24.04
vagrant init bento/ubuntu-24.04
```
The `init` command creates a VagrantFile with your initial configuration. In the same folder where this Vagrantfile is located, please execute the following command:
```shell
vagrant up
```
Then, connect to the Box using the following command:
```shell
vagrant ssh
```
If you get a terminal from the Box, your environment is ready.
### Common Networking Problems
If you have proxies or VPNs running on your machine, it is possible that Vagrant is not able to provision your environment. Please check your connectivity beforehand.
### Virtualization with VirtualBox
It is important to ensure that you can virtualize with VirtualBox. If you cannot, you may need to enable VT-X in your machine's BIOS. Here is how to enable it in the BIOS: [How to enable Intel VT-X and AMD SVM in the BIOS](https://www.qnap.com/en/how-to/faq/article/how-to-enable-intel-vt-x-and-amd-svm/)
### Vagrant Installation Videos
Here are videos on how to install Vagrant on different platforms:
- [Windows](https://www.youtube.com/watch?v=mPBWWu7sZU4)
- [MacOS](https://www.youtube.com/watch?v=kCVsWyR8mbo)
- [Linux](https://www.youtube.com/watch?v=yGviTwD3hWM)
To run all this setup, you need to have Git, Vagrant, and VirtualBox installed on your machine.
## Support
This tutorial is released into the public domain by [Agile611](http://www.agile611.com/) under the Creative Commons Attribution-NonCommercial 4.0 International license.
[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc/4.0/)
This README file was originally written by [Guillem Hernández Sola](https://www.linkedin.com/in/guillemhs/) and is likewise released into the public domain.
Please contact Agile611 for further details.
* [Agile611](http://www.agile611.com/)
* Carrer Laureà Miró 309
* 08950 Esplugues de Llobregat (Barcelona)