Comments (2)
Oh, I see now - I'd read the installation guide in this repository, but missed the separate installation guide for the UCCSER dev stack, which is expected to be installed first. Oh well, at least I learnt a bit about Traefik and confirmed that a WSL linux distro isn't strictly needed for Windows development. I'd clearly come across the other guide before, because I fixed a spelling mistake in it, but I must have missed the part where it required installing another repo first.
The best thing that could be done is mention the UCCSER dev stack installation guide as a prerequisite at the start of this one, to save anyone else going through the above.
from cs-field-guide.
I'm not sure how much of this is already known, but here are some issues I had with installation, and the somewhat hacky workarounds I found for them:
-
The
./dev
scripts of course don't run in the default Windows terminal, but they run fine through Git Bash with one exception: I needed to change/
to./
in front of/make-interactive-thumbnails.js
incmd_make_interactive_thumbnails()
, because otherwise Git Bash tries to runC:/Program Files/Git/make-interactive-thumbnails.js
. (It looks like this behaviour can be turned off in Git Bash by first runningexport MSYS_NO_PATHCONV=1
.) -
I needed to run
docker network create uccser-development-stack
before running the./dev
scripts, to prevent the errornetwork uccser-development-stack declared as external, but could not be found
. -
As far as I can tell, accessing
https://cs-field-guide.localhost
requires starting a Traefik service that isn't configured anywhere in this repository. I added the following service todocker-compose.local.yml
and then ran./dev start
again, after which I could accesshttps://cs-field-guide.localhost
in the browser. The commented lines allow debugging Traefik atlocalhost:8080
. This config doesn't set up any SSL certificates, so you still have to bypass the security warnings in the browser.
traefik:
image: traefik:latest
command:
- --providers.docker=true
- --providers.docker.exposedbydefault=false
- --entrypoints.web-secure.address=:443
# - --api.insecure=true
ports:
- 443:443
# - 8080:8080
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
networks:
- uccser-development-stack
I'm not sure these tips are ready to put straight into the troubleshooting guide, as I feel that these steps might not be necessary with some tweaks to the setup files, but since I came to GitHub issues looking for help getting set up and I found this issue at the top, I figured I would contribute to it with what I found to work for me.
from cs-field-guide.
Related Issues (20)
- Plane turbulence interactive thumbnail is of an error HOT 1
- CFG parsing challenge with the 'hide-generator' tag and no examples fails to load
- About and contributors page not indexed for search
- Trainsylvania map doesn't support translations
- Regular Expression Search interactive doesn't show syntax highlighting
- Computer Graphics Chapter HOT 2
- 3D Transform examples do not load HOT 5
- Improve education aspects of scene-editor interactive
- FSA page Trainsylvania activity refers to City Mall and Suburbopolis HOT 1
- [Bug]: A few issues on the Computer Security chapter main page HOT 1
- [Suggestion]: Display white favicon when browser dark theme is used
- [Bug]: Edges of hidden image are shown when embedding
- [Suggestion]: Modify Docker image publishing step to be consistent with other UCCSER repositories
- [Suggestion]: Use django 4.2.9
- [Bug]: Docs copyright year out of date
- Add mātanga section to contributors
- [Bug]: Link to "Entropy (information theory)" Wikipedia entry in coding-introduction/further-reading doesn't render properly
- [Bug]: Crowdin sync is failing HOT 1
- [Bug]: Readthedocs not updating with releases
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from cs-field-guide.