Hawk mono repository for development needs

Documentation

• How to use hawk.mono to run local Hawk
• How to send testing events to the local hawk
• How to view Registry queues

How to run

1. Run git submodule init && git submodule update.
2. Create .env file in those repositories where there is .env.sample file.
3. Run docker-compose up to run all hawk services or list only the necessary services in the command above.

Troubleshooting

If something went wrong, check this items.

/api dir is empty after using ./pull-all-submodules.sh

git submodule update --remote --merge

docker-compose up failed

There can be a problems if docker has an outdated image or volume. You can try rebuild it.

Removing and image

Try this commands:

docker-compose build --no-cache <service>

service are garage or api etc (see docker-compose.yml -> services)

If it does not help, remove docker image and build again:

1. List all images:

docker ps | grep hawk

2. Copy image name

3. Remove an image

docker image rm <name>

4. Rebuild

docker-compose up <service>

Removing a volume

1. List all volumes:

docker volume ls

2. Find a volume you want to remove. For example, hawkmono_api-deps

3. Remove volume

docker volume rm hawkmono_api-deps

4. Build

docker-compose build api

Executing Powershell scripts on Windows

To use Powershell scripts, you need to change the script execution policy in the system. Execute next command in Powershell terminal as administrator:

Set-ExecutionPolicy RemoteSigned

Pull all submodules

Run pull-all-submodules.ps1 script:

.\pull-all-submodules.ps1

Restore mongo data

Add your dump to dump\ folder and run mongorestore.ps1 script with collection name as parameter:

# Restore accounts data:
.\mongorestore.ps1 accounts

# Restore events data:
.\mongorestore.ps1 events