Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

news: add 1.0.1 entry #25

Closed
wants to merge 9 commits into from
34 changes: 34 additions & 0 deletions NEWS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,39 @@
# NEWS

## 1.0.1 - 2025-02-21

### Package distribution update

In previous releases, Ubuntu packages were available only through the Groonga
APT repository. Starting with this release, packages are also distributed via
packages.groonga.org.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is the difference between "the Groonga APT repository" and "package.groonga.org"?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fix: 9dd1041 I added the difference about the dependency package.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does "the Groonga APT repository" mean https://launchpad.net/~groonga/+archive/ubuntu/ppa ?
We should call it as "the Groonga APT repository". We should call https://packages.groonga.org/ as "the Groonga APT repository" because packages.groonga.org is managed by us.

Copy link
Contributor Author

@otegami otegami Feb 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fix: f24f394 I see. So both of them are "the Groonga APT repository".
I tried to rewrite it using specified url. What do you think of it? Or should I call the other ways?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, sorry.

We should call it as "the Groonga APT repository".

We should NOT call it as "the Groonga APT repository".


While the groonga-nginx package itself remains unchanged, the underlying Groonga
dependency is different. The packages from packages.groonga.org include Groonga
built with Apache Arrow enabled. Which unlocks extra features such as static
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
built with Apache Arrow enabled. Which unlocks extra features such as static
built with Apache Arrow enabled. Which unlocks extra features such as offline

https://groonga.org/docs/reference/indexing.html#offline-index-construction

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fix: ad73c68

parallel index building.

### Migration Notice for groonga-nginx
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Migration should only be required for Ubuntu users, so it is better to add that.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fix: dbc6986


If you’re currently using groonga-nginx, we recommend migrating to the packages
provided by groonga.packages.org. Although the Groonga APT repository will still
be available, it will no longer receive new updates in near future.

For migration, please follow these steps:

```console
$ sudo add-apt-repository --remove ppa:groonga/ppa
$ sudo apt install -y -V ca-certificates lsb-release wget
$ wget https://apache.jfrog.io/artifactory/arrow/$(lsb_release --id --short | tr 'A-Z' 'a-z')/apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ wget https://packages.groonga.org/$(lsb_release --id --short | tr 'A-Z' 'a-z')/groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt update
$ sudo apt install -y -V libnginx-mod-http-groonga
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ppaからインストールした libgroonga0 とかが残っていても大丈夫ですか?
libnginx-mod-http-groonga はまだ packages.groonga.org にないですが、これで移行できるかどのように確認しました?

Copy link
Contributor Author

@otegami otegami Feb 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

現状確認できないので、リリースしてから確認するしかないのかなぁと考えていました。
ここには詳細を書かないで、README.mdを見てねと促して、あとから確認できた手段を明記したほうが良さそうですかねmm

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

不確定な情報を記載するよりは、確実な情報を記載したほうが良いので、移行方法はあとからREADMEとかに書くほうが良かろうと思います。
(MIGRATION.md とか別ファイルを作っても良さそうです。)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Groongaの方に書いてそっちを参照でもいいかも。

Groongaの方はもうリリース済みだから動作確認できるよね?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一旦、ここまでで作業を止めてGroonga側に移行方法のドキュメントを書こうと思います。

```

## 1.0.0 - 2023-07-21

Initial release!
15 changes: 2 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,14 @@ This was formerly distributed with Groonga and provided as `groonga-httpd` with
## Install

Debian GNU/Linux bookworm or later:
Ubuntu 24.04 or later:

```console
$ sudo apt install -y -V ca-certificates lsb-release wget
$ wget https://apache.jfrog.io/artifactory/arrow/$(lsb_release --id --short | tr 'A-Z' 'a-z')/apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
$ wget https://packages.groonga.org/debian/groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ wget https://packages.groonga.org/$(lsb_release --id --short | tr 'A-Z' 'a-z')/groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt install -y -V ./groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ rm -f groonga-apt-source-latest-$(lsb_release --codename --short).deb
$ sudo apt update
Expand All @@ -23,18 +24,6 @@ $ sudo editor /etc/nginx/conf.d/groonga.conf
$ sudo systemctl restart nginx
```

Ubuntu 23.10 or later:

```console
$ sudo apt -y -V install software-properties-common
$ sudo add-apt-repository -y universe
$ sudo add-apt-repository -y ppa:groonga/ppa
$ sudo apt install -y -V libnginx-mod-http-groonga
$ sudo cp /etc/nginx/groonga.conf /etc/nginx/conf.d/
$ sudo editor /etc/nginx/conf.d/groonga.conf
$ sudo systemctl restart nginx
```

## Configure

You need to configure your `/etc/nginx/conf.d/groonga.conf` to use this module.
Expand Down
Loading