https://github.com/movableink/sre-assignment-golang
This repository contains a bare-bones Golang HTTP service template that's part of the Studio SRE take home assignment.
https://github.com/movableink/sre-assignment-golang
Last synced: 2 months ago
JSON representation
This repository contains a bare-bones Golang HTTP service template that's part of the Studio SRE take home assignment.
- Host: GitHub
- URL: https://github.com/movableink/sre-assignment-golang
- Owner: movableink
- Created: 2025-02-24T12:41:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-25T23:20:32.000Z (over 1 year ago)
- Last Synced: 2026-02-19T04:24:09.542Z (4 months ago)
- Language: Go
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GeoIP Service
A Go-based service that provides geographical information for IP addresses using the Movable Ink GeoIP API.
## Prerequisites
- Go 1.21 or higher
## Installation
1. Clone the repository:
```bash
git clone https://github.com/movableink/sre-assignment-golang.git
cd sre-assignment-golang
```
2. Install dependencies:
```bash
go mod download
```
## Configuration
The service requires the following environment variables:
- `API_URL`: The base URL for the Movable Ink GeoIP API (default: http://localhost:8000). A production URL will be provided by Movable Ink.
- `API_TOKEN`: Your API token for authentication with the Movable Ink GeoIP API. This is required for production use.
- `PORT`: The port number for the service (default: 3000)
## Running the Service
Build and start the service (don't forget to set your environment variables before starting):
```bash
go build -o server ./cmd/server
./server
```
The service will be available at `http://localhost:3000`.
## API Endpoints
### GET /lookup/:ip
Returns geographical information for the specified IP address.
Example request:
```bash
curl http://localhost:3000/lookup/8.8.8.8
```
Example successful response:
```json
{
"ip": "8.8.8.8",
"location": "United States",
"postal_code": "",
"network_name": "AS15169 GOOGLE",
"domain": "Google",
"latitude": 37.751,
"longitude": -97.822
}
```
Example error response (500 Internal Server Error):
```json
{
"error": "API request failed: "
}
```
## Testing
### IP Address Testing Script
The repository includes a bash script (`test-ips.sh`) that tests the service with a list of IP addresses from `test_ips.txt`. If test_ips.txt is not available you can create your own file and enter an ip address per line for testing. For the assignment the test_ips.txt file will be provided by Movable Ink.
To run the tests:
1. Make sure the service is running in one terminal:
```bash
./server
```
2. In another terminal, run the test script:
```bash
./test-ips.sh
```
The script will:
- Process each IP address in `test_ips.txt`
- Show progress every 100 requests
- Display a summary including:
- Total number of requests
- Total time taken
- Average requests per second
- Distribution of HTTP status codes
## Project Structure
- `cmd/server/`: Main application entry point
- `main.go`: Server implementation
- `internal/`: Internal packages
- `config/`: Configuration management
- `geoip/`: GeoIP service implementation
- `go.mod`: Go module definition and dependencies
- `test-ips.sh`: Testing script
## License
This project is proprietary and confidential to Movable Ink.