From eed2a877ece347d8651e356baae18c6bf55b07d0 Mon Sep 17 00:00:00 2001 From: Steve Loeppky Date: Thu, 6 Apr 2023 05:22:57 -0700 Subject: [PATCH 1/8] Preparing 0.20 changelog for release Preparing 0.20.md for 0.20 release: https://github.com/ipfs/kubo/issues/9694 --- docs/changelogs/v0.20.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index c1c3e9639d0..2ffa4413e29 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -13,6 +13,18 @@ ### ๐Ÿ”ฆ Highlights +#### New gateway powers +@lidel + +#### Accelerated DHT Client +@jorropo + +#### Boxo under the covers +@guseggert + +Per usual, various bug and performance fixes. +Anything regarding go-libp2p updates we want to say? + ### ๐Ÿ“ Changelog ### ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Contributors From efe3738410f3602cf44923e45202bd3bd8a75333 Mon Sep 17 00:00:00 2001 From: Gus Eggert Date: Thu, 6 Apr 2023 17:15:23 -0400 Subject: [PATCH 2/8] Remove Accelerated DHT Client This was dropped from this release --- docs/changelogs/v0.20.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 2ffa4413e29..161ede7a2f0 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -16,9 +16,6 @@ #### New gateway powers @lidel -#### Accelerated DHT Client -@jorropo - #### Boxo under the covers @guseggert From 95b2e5a66e3ee91339892eb27deafb5377c0084d Mon Sep 17 00:00:00 2001 From: Gus Eggert Date: Thu, 6 Apr 2023 23:21:47 -0400 Subject: [PATCH 3/8] Add Boxo section --- docs/changelogs/v0.20.md | 41 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 161ede7a2f0..82178c52009 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -6,6 +6,7 @@ - [Overview](#overview) - [๐Ÿ”ฆ Highlights](#-highlights) + - [Boxo under the covers](#boxo-under-the-covers) - [๐Ÿ“ Changelog](#-changelog) - [๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Contributors](#-contributors) @@ -17,7 +18,43 @@ @lidel #### Boxo under the covers -@guseggert +We have consolidated many IPFS repos into [Boxo](https://github.com/ipfs/boxo), and this release switches Kubo over to use Boxo instead of those repos, resulting in the removal of 27 dependencies from Kubo: + +- github.com/ipfs/go-bitswap +- github.com/ipfs/go-ipfs-files +- github.com/ipfs/tar-utils +- gihtub.com/ipfs/go-block-format +- github.com/ipfs/interface-go-ipfs-core +- github.com/ipfs/go-unixfs +- github.com/ipfs/go-pinning-service-http-client +- github.com/ipfs/go-path +- github.com/ipfs/go-namesys +- github.com/ipfs/go-mfs +- github.com/ipfs/go-ipfs-provider +- github.com/ipfs/go-ipfs-pinner +- github.com/ipfs/go-ipfs-keystore +- github.com/ipfs/go-filestore +- github.com/ipfs/go-ipns +- github.com/ipfs/go-blockservice +- github.com/ipfs/go-ipfs-chunker +- github.com/ipfs/go-fetcher +- github.com/ipfs/go-ipfs-blockstore +- github.com/ipfs/go-ipfs-posinfo +- github.com/ipfs/go-ipfs-util +- github.com/ipfs/go-ipfs-ds-help +- github.com/ipfs/go-verifcid +- github.com/ipfs/go-ipfs-exchange-offline +- github.com/ipfs/go-ipfs-routing +- github.com/ipfs/go-ipfs-exchange-interface +- github.com/ipfs/go-libipfs + +If you consume these in your own code, we recommend migrating to Boxo. To ease this process, there's a tool which will migrate your code to Boxo. See: https://github.com/ipfs/boxo#migrating-to-boxo . + +Boxo maintainers are happy to answer questions or help, just open an issue: https://github.com/ipfs/boxo/issues/new/choose + + + + Per usual, various bug and performance fixes. Anything regarding go-libp2p updates we want to say? @@ -25,3 +62,5 @@ Anything regarding go-libp2p updates we want to say? ### ๐Ÿ“ Changelog ### ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Contributors + + From 613f64a8db247518ef02823e324ee095766fdf24 Mon Sep 17 00:00:00 2001 From: Steve Loeppky Date: Tue, 11 Apr 2023 16:40:10 -0700 Subject: [PATCH 4/8] Some updates on the Boxo section. --- docs/changelogs/v0.20.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 82178c52009..2d54de4b0b0 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -48,13 +48,11 @@ We have consolidated many IPFS repos into [Boxo](https://github.com/ipfs/boxo), - github.com/ipfs/go-ipfs-exchange-interface - github.com/ipfs/go-libipfs -If you consume these in your own code, we recommend migrating to Boxo. To ease this process, there's a tool which will migrate your code to Boxo. See: https://github.com/ipfs/boxo#migrating-to-boxo . - -Boxo maintainers are happy to answer questions or help, just open an issue: https://github.com/ipfs/boxo/issues/new/choose - - +Note: if you consume these in your own code, we recommend migrating to Boxo. To ease this process, there's a [tool which will help migrate your code to Boxo](https://github.com/ipfs/boxo#migrating-to-box). +You can learn more about the [Boxo 0.8 release](https://github.com/ipfs/boxo/releases/tag/v0.8.0) that Kubo now depends and the general effort to get Boxo to be a stable foundation [here](https://github.com/ipfs/boxo/issues/196). +--- Per usual, various bug and performance fixes. Anything regarding go-libp2p updates we want to say? From 676c5dda42fca074a781ee4f8853f2c15c7c0ada Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Wed, 12 Apr 2023 21:51:45 +0200 Subject: [PATCH 5/8] docs(changelog): gateway section for 0.20 --- docs/changelogs/v0.20.md | 59 +++++++++++++++++++++++++++++++++++++--- 1 file changed, 55 insertions(+), 4 deletions(-) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 2d54de4b0b0..248f346828d 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -7,6 +7,11 @@ - [Overview](#overview) - [๐Ÿ”ฆ Highlights](#-highlights) - [Boxo under the covers](#boxo-under-the-covers) + - [HTTP Gateway](#http-gateway) + - [Switch to `boxo/gateway` library](#switch-to-boxogateway-library) + - [Improved testing](#improved-testing) + - [Trace Context support](#trace-context-support) + - [Removed legacy features](#removed-legacy-features) - [๐Ÿ“ Changelog](#-changelog) - [๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Contributors](#-contributors) @@ -14,9 +19,6 @@ ### ๐Ÿ”ฆ Highlights -#### New gateway powers -@lidel - #### Boxo under the covers We have consolidated many IPFS repos into [Boxo](https://github.com/ipfs/boxo), and this release switches Kubo over to use Boxo instead of those repos, resulting in the removal of 27 dependencies from Kubo: @@ -55,7 +57,56 @@ You can learn more about the [Boxo 0.8 release](https://github.com/ipfs/boxo/rel --- Per usual, various bug and performance fixes. -Anything regarding go-libp2p updates we want to say? +Anything regarding boxo updates we want to say? + +#### HTTP Gateway + +##### Switch to `boxo/gateway` library + +Gateway code was extracted and refactored into a standalone library that now +lives in [boxo/gateway](https://github.com/ipfs/boxo/tree/main/gateway). This +enabled us to clean up some legacy code and remove dependency on Kubo +internals. + +The GO API is still being refined, but now operates on higher level abstraction +defined by `gateway.IPFSBackend` interface. It is now possible to embed +gateway functionality without the rest of Kubo. + +See the [car](https://github.com/ipfs/boxo/tree/main/examples/gateway/car) +and [proxy](https://github.com/ipfs/boxo/tree/main/examples/gateway/proxy) +examples, or more advanced +[bifrost-gateway](https://github.com/ipfs/bifrost-gateway). + +##### Improved testing + +We are also in the progress of moving away from gateway testing being based on +Kubo sharness tests, and are working on +[ipfs/gateway-conformance](https://github.com/ipfs/gateway-conformance) test +suite that is vendor agnostic and can be run against arbitrary HTTP endpoint to +test specific subset of [HTTP Gateways specifications](https://specs.ipfs.tech/http-gateways/). + +##### Trace Context support + +We've introduced initial support for `traceparent` header from [W3C's Trace +Context spec](https://w3c.github.io/trace-context/). + +If `traceparent` header is +present in the gateway request, one can use its `trace-id` part to inspect +trace spans via selected exporter such as Jaeger UI +([docs](https://github.com/ipfs/boxo/blob/main/docs/tracing.md#using-jaeger-ui), +[demo](https://user-images.githubusercontent.com/157609/231312374-bafc2035-1fc6-4d6b-901b-9e4af039807c.png)). + +To learn more, see [tracing docs](https://github.com/ipfs/boxo/blob/main/docs/tracing.md). + +##### Removed legacy features + +- Some Kubo-specific prometheus metrics are no longer available. + - An up-to-date list of gateway metrics can be found in [boxo/gateway/metrics.go](https://github.com/ipfs/boxo/blob/main/gateway/metrics.go). +- The legacy opt-in `Gateway.Writable` is no longer available as of Kubo 0.20. + - We are working on developing a modern replacement. + To support our efforts, please leave a comment describing your use case in + [ipfs/specs#375](https://github.com/ipfs/specs/issues/375). + ### ๐Ÿ“ Changelog From 53fced4ac334d22f84b2a3e1da9bdb51b4e2eec6 Mon Sep 17 00:00:00 2001 From: Steve Loeppky Date: Wed, 12 Apr 2023 15:03:32 -0700 Subject: [PATCH 6/8] Update v0.20.md --- docs/changelogs/v0.20.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 248f346828d..062b57935cb 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -54,11 +54,6 @@ Note: if you consume these in your own code, we recommend migrating to Boxo. To You can learn more about the [Boxo 0.8 release](https://github.com/ipfs/boxo/releases/tag/v0.8.0) that Kubo now depends and the general effort to get Boxo to be a stable foundation [here](https://github.com/ipfs/boxo/issues/196). ---- - -Per usual, various bug and performance fixes. -Anything regarding boxo updates we want to say? - #### HTTP Gateway ##### Switch to `boxo/gateway` library From 9829923f04184d4657a96c33eb8a3cc32f2c09db Mon Sep 17 00:00:00 2001 From: Henrique Dias Date: Thu, 13 Apr 2023 15:51:17 +0200 Subject: [PATCH 7/8] Update v0.20.md --- docs/changelogs/v0.20.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 062b57935cb..4782ffe5eef 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -102,6 +102,11 @@ To learn more, see [tracing docs](https://github.com/ipfs/boxo/blob/main/docs/tr To support our efforts, please leave a comment describing your use case in [ipfs/specs#375](https://github.com/ipfs/specs/issues/375). +#### `--empty-repo` is now the default + +When creating a repository with `ipfs init`, `--empty-repo=true` is now the default. This means +that your repository will be empty by default instead of containing the introduction files. +You can read more about the rationale behind this decision on the [tracking issue](https://github.com/ipfs/kubo/issues/9757). ### ๐Ÿ“ Changelog From 01d3ea392eaa12dd92b8f718c2fe8e37fbb7f7b2 Mon Sep 17 00:00:00 2001 From: Henrique Dias Date: Thu, 13 Apr 2023 15:52:25 +0200 Subject: [PATCH 8/8] Update v0.20.md --- docs/changelogs/v0.20.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/changelogs/v0.20.md b/docs/changelogs/v0.20.md index 4782ffe5eef..9809d4703b2 100644 --- a/docs/changelogs/v0.20.md +++ b/docs/changelogs/v0.20.md @@ -12,6 +12,7 @@ - [Improved testing](#improved-testing) - [Trace Context support](#trace-context-support) - [Removed legacy features](#removed-legacy-features) + - [`--empty-repo` is now the default](#--empty-repo-is-now-the-default) - [๐Ÿ“ Changelog](#-changelog) - [๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Contributors](#-contributors)