Skip to content

Commit

Permalink
Update README.md with troubleshooting
Browse files Browse the repository at this point in the history
  • Loading branch information
skawaguchi-flipp authored and dorner committed Jan 16, 2024
1 parent 34beb0a commit 7894dcd
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -199,3 +199,38 @@ The steps to add a new service are:
2. Add the functionality for your command in `gdc/docker.go`.
3. Add a new command under `cmd/gdc/commands`. You can copy and paste an existing one or make changes. `global_docker_compose` uses [Cobra](https://github.com/spf13/cobra) for command-line flags, validations, help text and arguments, so please read that documentation for more info.
4. Put up your PR!


## Troubleshooting

If you are on an M* macOS machine, you might run into trouble getting GDC to run.

### Error: `no matching manifest for linux/arm64/v8 in the manifest list entries`

We had to apply these fixes:

```sh
docker pull --platform linux/x86_64 MySQL
export DOCKER_DEFAULT_PLATFORM=linux/x86_64/v8 # you might want to put this in your rc or profile file
```

Then re-run `gdc up`.

#### References
[StackOverflow Ref]([url](https://stackoverflow.com/questions/65456814/docker-apple-silicon-m1-preview-mysql-no-matching-manifest-for-linux-arm64-v8/67361161#67361161)https://stackoverflow.com/questions/65456814/docker-apple-silicon-m1-preview-mysql-no-matching-manifest-for-linux-arm64-v8/67361161#67361161)
[Use Colima to run Docker containers]([url](https://smallsharpsoftwaretools.com/tutorials/use-colima-to-run-docker-containers-on-macos/)https://smallsharpsoftwaretools.com/tutorials/use-colima-to-run-docker-containers-on-macos/)

### Error: `unknown shorthand flag: 'p' in -p`

#### References

To fix this, we had to run:

```sh
ln -sfn $(brew --prefix)/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose
```

We also made sure `colima`, `docker`, `docker-compose` and `XCode` were all up to date.

[Fadmin Troubleshooting docs]([url](https://flippit.atlassian.net/wiki/spaces/CTLR/pages/10448437272/End-to-end+Fadmin+WES+local+setup#Troubleshooting)https://flippit.atlassian.net/wiki/spaces/CTLR/pages/10448437272/End-to-end+Fadmin+WES+local+setup#Troubleshooting)

0 comments on commit 7894dcd

Please sign in to comment.