Q: This error means a GitHub ID exceeded the range of a 32-bit integer column. The full message is usually something like: ``` ActiveModel::RangeError (12345678901 is out of range for ActiveModel::Type::Integer with limit 4) ``` GitHub's notification/comment IDs have grown past the 2,147,483,647 limit of a 4-byte `integer` column, so when Octobox tries to save a notification during `NotificationsController#sync`, the assignment to `github_id` raises this error. The fix is to convert those columns to `bigint`. ## If you're running stock Octobox This was fixed upstream, so the easiest path is: 1. Pull the latest Octobox code (or Docker image). 2. Run the migrations: ```bash RAILS_ENV=production bundle exec rake db:migrate ``` 3. Restart the app. Deployment-specific variants: ```bash # Docker docker exec -it rake db:migrate # Heroku heroku run rake db:migrate ``` ## If you're on an old fork or the migration isn't present Back up your database, then create a migration: ```bash rails generate migration change_github_ids_to_bigint ``` ```ruby class ChangeGithubIdsToBigint < ActiveRecord::Migration[5.2] def up change_column :notifications, :github_id, :bigint change_column :subjects, :github_id, :bigint end def down change_column :notifications, :github_id, :integer change_column :subjects, :github_id, :integer end end ``` Then run `rake db:migrate` and restart. This works on both PostgreSQL and MySQL. ## Notes - Don't just edit `schema.rb` — the change must be applied via a migration so the actual column type in the database changes. - If the error persists after migrating, check the backtrace for which attribute is overflowing; other ID columns (e.g., on comments or related records) may need the same `bigint` treatment. - If sync is completely stuck because one bad record keeps failing, migrating the column resolves it — you don't need to delete the offending notification.

이 오류는 `2148162568`과 같은 GitHub ID가 영향을 받는 Octobox 버전에서 사용하는 4바이트 부호 있는 정수 한도(`2147483647`)를 초과하기 때문에 발생합니다. 커밋 `202d5f64a395b7eb6ba0e72cf8e0b189a3c48d46`이 포함된 수정된 Docker 이미지로 업그레이드하세요: ```sh docker pull octoboxio/octobox:range-error-fix ``` 그런 다음 Octobox 컨테이너를 다시 생성하고 Rails 데이터베이스 마이그레이션이 실행되도록 하세요. Docker Compose 사용 시: ```sh docker compose pull docker compose up -d ``` `january-2024` 이미지는 영향을 받습니다. `range-error-fix` 또는 그 이후의 공식 Octobox 릴리스를 사용하세요.

Q: Octobox Docker Compose 예제를 사용할 때 백그라운드 작업(Sidekiq)이 왜 실패하나요?

`octobox:latest` Docker 이미지에는 Rails 7 및 Sidekiq 7이 포함되어 있으며, 이들은 Redis 6+가 필요합니다. 오래된 커밋에 고정된 `sidekiq-unique-jobs` gem의 구버전이 Redis 6+의 엄격한 부울 타입과 호환성 문제를 일으켰습니다. 이는 `sidekiq-unique-jobs`를 최신 버전으로 업데이트하여 수정되었습니다. 최신 이미지를 가져오거나 Gemfile을 업데이트하여 현재 코드베이스를 사용하십시오.

Q: Octobox 검색에서 '-bot:true'가 무시되는 이유는 무엇이며 봇 알림을 제외하려면 어떻게 해야 하나요?

Octobox 검색은 repo, owner, type, reason, label, state, author, number, assignee 및 status 접두사에 대해서만 `-` 부정 연산자를 지원합니다. `bot`, `starred`, `unread`, `draft`, `is_private`와 같은 불리언 접두사는 아무런 경고 없이 부정을 무시하므로, `inbox:true -bot:true`는 `inbox:true`와 동일한 결과를 반환합니다. 해결 방법: 접두사를 부정하는 대신 불리언 값을 반전시키세요. 봇이 작성한 알림을 숨기려면 `bot:false`(예: `inbox:true bot:false`)를 사용하세요. 동일한 패턴이 다른 불리언 필터에도 적용됩니다: `starred:false`, `unread:false`, `draft:false`, `is_private:false`.

Q: nginx와 Cloudflare 뒤에서 Octobox를 사용할 때 WebSocket wss://.../cable 301 리다이렉트를 어떻게 수정하나요?

`/cable`에 대한 301 응답이 동일한 `wss://`/HTTPS URL로 리디렉션하는 경우, 일반적으로 리버스 프록시가 WebSocket 엔드포인트를 프록시하지 않고 리디렉션하고 있다는 의미입니다. 다음 명령으로 확인하세요: ```bash curl -v https://your-domain/cable ``` `location: https://your-domain/cable`과 함께 `301`을 반환한다면 nginx를 확인하세요. WebSocket 업그레이드 헤더를 전달하고 리디렉션하지 않는 전용 `/cable` location을 추가하세요: ```nginx map $http_upgrade $connection_upgrade { default upgrade; '' close; } server { location /cable { proxy_pass http://your-octobox-upstream; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection $connection_upgrade; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto; proxy_redirect off; } } ``` 일반적인 HTTP-to-HTTPS 리디렉션이나 `force_ssl` 규칙이 `/cable`을 가로채지 않는지 확인하세요. 그런 다음 nginx를 다시 로드하세요: ```bash sudo nginx -t && sudo systemctl reload nginx ``` 또한 Cloudflare가 Full/Full (strict) SSL 모드를 사용하고 있으며 WebSocket 지원이 활성화되어 있는지 확인하세요. 보고된 octobox.io 장애 사례에서 근본 원인은 Cloudflare 뒤단의 nginx 구성 문제였으며, 프록시 구성을 수정하여 WebSocket 연결이 복구되었습니다.

Question 1

This error means a GitHub ID exceeded the range of a 32-bit integer column. The full message is usually something like:

```
ActiveModel::RangeError (12345678901 is out of range for ActiveModel::Type::Integer with limit 4)
```

GitHub's notification/comment IDs have grown past the 2,147,483,647 limit of a 4-byte `integer` column, so when Octobox tries to save a notification during `NotificationsController#sync`, the assignment to `github_id` raises this error. The fix is to convert those columns to `bigint`.

## If you're running stock Octobox

This was fixed upstream, so the easiest path is:

1. Pull the latest Octobox code (or Docker image).
2. Run the migrations:

```bash
RAILS_ENV=production bundle exec rake db:migrate
```

3. Restart the app.

Deployment-specific variants:

```bash
# Docker
docker exec -it <container_name> rake db:migrate

# Heroku
heroku run rake db:migrate
```

## If you're on an old fork or the migration isn't present

Back up your database, then create a migration:

```bash
rails generate migration change_github_ids_to_bigint
```

```ruby
class ChangeGithubIdsToBigint < ActiveRecord::Migration[5.2]
  def up
    change_column :notifications, :github_id, :bigint
    change_column :subjects, :github_id, :bigint
  end

def down
    change_column :notifications, :github_id, :integer
    change_column :subjects, :github_id, :integer
  end
end
```

Then run `rake db:migrate` and restart. This works on both PostgreSQL and MySQL.

## Notes

- Don't just edit `schema.rb` — the change must be applied via a migration so the actual column type in the database changes.
- If the error persists after migrating, check the backtrace for which attribute is overflowing; other ID columns (e.g., on comments or related records) may need the same `bigint` treatment.
- If sync is completely stuck because one bad record keeps failing, migrating the column resolves it — you don't need to delete the offending notification.

Accepted Answer

이 오류는 `2148162568`과 같은 GitHub ID가 영향을 받는 Octobox 버전에서 사용하는 4바이트 부호 있는 정수 한도(`2147483647`)를 초과하기 때문에 발생합니다. 커밋 `202d5f64a395b7eb6ba0e72cf8e0b189a3c48d46`이 포함된 수정된 Docker 이미지로 업그레이드하세요:

```sh
docker pull octoboxio/octobox:range-error-fix
```

그런 다음 Octobox 컨테이너를 다시 생성하고 Rails 데이터베이스 마이그레이션이 실행되도록 하세요. Docker Compose 사용 시:

```sh
docker compose pull
docker compose up -d
```

`january-2024` 이미지는 영향을 받습니다. `range-error-fix` 또는 그 이후의 공식 Octobox 릴리스를 사용하세요.

Question 2

Octobox Docker Compose 예제를 사용할 때 백그라운드 작업(Sidekiq)이 왜 실패하나요?

Accepted Answer

`octobox:latest` Docker 이미지에는 Rails 7 및 Sidekiq 7이 포함되어 있으며, 이들은 Redis 6+가 필요합니다. 오래된 커밋에 고정된 `sidekiq-unique-jobs` gem의 구버전이 Redis 6+의 엄격한 부울 타입과 호환성 문제를 일으켰습니다. 이는 `sidekiq-unique-jobs`를 최신 버전으로 업데이트하여 수정되었습니다. 최신 이미지를 가져오거나 Gemfile을 업데이트하여 현재 코드베이스를 사용하십시오.

Question 3

Octobox 검색에서 '-bot:true'가 무시되는 이유는 무엇이며 봇 알림을 제외하려면 어떻게 해야 하나요?

Accepted Answer

Octobox 검색은 repo, owner, type, reason, label, state, author, number, assignee 및 status 접두사에 대해서만 `-` 부정 연산자를 지원합니다. `bot`, `starred`, `unread`, `draft`, `is_private`와 같은 불리언 접두사는 아무런 경고 없이 부정을 무시하므로, `inbox:true -bot:true`는 `inbox:true`와 동일한 결과를 반환합니다. 해결 방법: 접두사를 부정하는 대신 불리언 값을 반전시키세요. 봇이 작성한 알림을 숨기려면 `bot:false`(예: `inbox:true bot:false`)를 사용하세요. 동일한 패턴이 다른 불리언 필터에도 적용됩니다: `starred:false`, `unread:false`, `draft:false`, `is_private:false`.

Question 4

nginx와 Cloudflare 뒤에서 Octobox를 사용할 때 WebSocket wss://.../cable 301 리다이렉트를 어떻게 수정하나요?

Accepted Answer

`/cable`에 대한 301 응답이 동일한 `wss://`/HTTPS URL로 리디렉션하는 경우, 일반적으로 리버스 프록시가 WebSocket 엔드포인트를 프록시하지 않고 리디렉션하고 있다는 의미입니다. 다음 명령으로 확인하세요:

```bash
curl -v https://your-domain/cable
```

`location: https://your-domain/cable`과 함께 `301`을 반환한다면 nginx를 확인하세요. WebSocket 업그레이드 헤더를 전달하고 리디렉션하지 않는 전용 `/cable` location을 추가하세요:

```nginx
map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

server {
  location /cable {
    proxy_pass http://your-octobox-upstream;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
    proxy_redirect off;
  }
}
```

일반적인 HTTP-to-HTTPS 리디렉션이나 `force_ssl` 규칙이 `/cable`을 가로채지 않는지 확인하세요. 그런 다음 nginx를 다시 로드하세요:

```bash
sudo nginx -t && sudo systemctl reload nginx
```

또한 Cloudflare가 Full/Full (strict) SSL 모드를 사용하고 있으며 WebSocket 지원이 활성화되어 있는지 확인하세요. 보고된 octobox.io 장애 사례에서 근본 원인은 Cloudflare 뒤단의 nginx 구성 문제였으며, 프록시 구성을 수정하여 WebSocket 연결이 복구되었습니다.

Octobox

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트