Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions .devcontainer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Dev Containers

> The Visual Studio Code Dev Containers extension lets you use a container as a full-featured development environment. It allows you to open any folder inside (or mounted into) a container and take advantage of Visual Studio Code's full feature set. A devcontainer.json file in your project tells VS Code how to access (or create) a development container with a well-defined tool and runtime stack. This container can be used to run an application or to separate tools, libraries, or runtimes needed for working with a codebase.

Source: [Developing inside a Container](https://code.visualstudio.com/docs/devcontainers/containers)

## Tips and Tricks

[Dev Containers Tips and Tricks](https://code.visualstudio.com/docs/devcontainers/tips-and-tricks)

## Troubleshooting

### "You don't have enough free space in /var/cache/apt/archives/"

Check the Docker Build Cache:
```sh
docker system df
```

If the cache is full, clean it:
```sh
docker builder prune --all
```
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
* text=auto eol=lf
*.{cmd,[cC][mM][dD]} text eol=crlf
*.{bat,[bB][aA][tT]} text eol=crlf
1 change: 1 addition & 0 deletions ansible/inventory/group_vars/debian/vars.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ dev_apt_packages:
- make
- python3-pip
- python3-venv
- pipx
- pre-commit
- shellcheck
- tshark
Expand Down
1 change: 1 addition & 0 deletions docs/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ The repository includes a [devcontainer](https://code.visualstudio.com/docs/devc
Using Visual Studio Code, the [Dev Containers Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) and Docker the development (e.g. adding more services, building the documentation) and administration tasks (e.g. running an Ansible playbook) can be performed on any environment without additional software installation.

Follow the [Dev Containers tutorial](https://code.visualstudio.com/docs/devcontainers/tutorial) to get started.
For troubleshooting, tips and tricks see [Dev Containers](../.devcontainer/README.md).

Note: the resulting container image is pretty large (4+ GB) as it includes all software configured in `ansible/inventory/group_vars/debian/vars.yaml`.

Expand Down