Closed BigLep closed 3 years ago
improvements that will enable us to release faster with more effort.
more effort, or less effort?
@eminence : doh - fixed - thanks!
Contributor | Commits | Lines Β± | Files Changed |
---|---|---|---|
Daniel MartΓ | 42 | +8549/-6587 | 170 |
Eric Myhre | 55 | +5883/-6715 | 395 |
Marten Seemann | 100 | +1814/-2028 | 275 |
Steven Allen | 80 | +1573/-1998 | 127 |
hannahhoward | 18 | +1721/-671 | 53 |
Will | 2 | +1114/-1217 | 18 |
Andrew Gillis | 2 | +1220/-720 | 14 |
gammazero | 3 | +43/-1856 | 10 |
Masih H. Derkani | 3 | +960/-896 | 8 |
Adin Schmahmann | 25 | +1458/-313 | 44 |
vyzo | 27 | +986/-353 | 60 |
Will Scott | 6 | +852/-424 | 16 |
Rod Vagg | 19 | +983/-255 | 66 |
Petar Maymounkov | 6 | +463/-179 | 22 |
web3-bot | 10 | +211/-195 | 24 |
adlrocha | 1 | +330/-75 | 15 |
RubenKelevra | 2 | +128/-210 | 2 |
Ian Davis | 3 | +200/-109 | 17 |
Cory Schwartz | 3 | +231/-33 | 7 |
Keenan Nemetz | 1 | +184/-71 | 2 |
Randy Reddig | 2 | +187/-53 | 8 |
Takashi Matsuda | 3 | +201/-2 | 7 |
guseggert | 4 | +161/-20 | 9 |
Lucas Molas | 5 | +114/-47 | 27 |
nisdas | 4 | +115/-45 | 7 |
Michael MurΓ© | 6 | +107/-33 | 24 |
Richard Ramos | 2 | +113/-9 | 3 |
Marcin Rataj | 12 | +88/-24 | 13 |
Ondrej Prazak | 2 | +104/-6 | 4 |
Michal Dobaczewski | 2 | +77/-28 | 3 |
Jorropo | 3 | +9/-75 | 4 |
Andey Robins | 1 | +70/-3 | 3 |
Gus Eggert | 10 | +34/-31 | 12 |
noot | 1 | +54/-9 | 5 |
Maxim Merzhanov | 1 | +29/-24 | 1 |
Adrian Lanzafame | 1 | +30/-13 | 2 |
Bogdan Stirbat | 1 | +22/-16 | 2 |
Shad Sterling | 1 | +28/-3 | 1 |
Jesse Bouwman | 5 | +30/-0 | 5 |
Pavel Karpy | 1 | +19/-7 | 2 |
lasiar | 5 | +14/-10 | 5 |
Dennis Trautwein | 1 | +20/-4 | 2 |
Louis Thibault | 1 | +22/-1 | 2 |
whyrusleeping | 2 | +21/-1 | 2 |
aarshkshah1992 | 3 | +12/-8 | 3 |
Peter Rabbitson | 2 | +20/-0 | 2 |
bt90 | 2 | +17/-2 | 2 |
Dominic Della Valle | 1 | +13/-1 | 2 |
Audrius Butkevicius | 1 | +12/-1 | 1 |
Brian Strauch | 1 | +9/-3 | 1 |
Aarsh Shah | 2 | +1/-11 | 2 |
Whyrusleeping | 1 | +11/-0 | 1 |
Max | 1 | +7/-3 | 1 |
vallder | 1 | +3/-5 | 1 |
Michael Burns | 3 | +2/-6 | 3 |
Lasse Johnsen | 1 | +4/-4 | 2 |
snyh | 1 | +5/-2 | 1 |
Hector Sanjuan | 2 | +3/-2 | 2 |
εΈε·ζδ½ (ebi) | 1 | +1/-3 | 1 |
godcong | 2 | +2/-1 | 2 |
Mathis Engelbart | 1 | +1/-2 | 1 |
folbrich | 1 | +1/-1 | 1 |
Med Mouine | 1 | +1/-1 | 1 |
Would you like to contribute to the IPFS project and don't know how? Well, there are a few places you can get started:
help wanted
label in the go-ipfs repoMy reading of this is that this doesn't include the pending move of the blockstore from cids to multihashes. Is that correct?
@ianopolous correct. That is currently planned to be a release all of its own (i.e. that will be the only change in that release in order to ease people through the migration). It's currently scheduled for v0.12.0
Is anyone aware of anything like https://deno.land/benchmarks for go-ipfs? The switch to go-ipld-prime under the hood is very exciting (thanks @hannahhoward !). To help assess release candidates, I'd really appreciate the sanity checks an automated set of benchmarks run between releases would provide.
Early testers ping for RC1 testing π
<List of items with PRs and/or Issues to be considered for this release>
Early testers ping for RC testing π
- [ ] pacman.store (@RubenKelevra)
- [ ] Infura (@MichaelMure)
- [ ] Textile (@sanderpick)
- [x] Pinata (@obo20)
- [ ] RTrade (@postables)
- [ ] QRI (@b5)
- [ ] Siderus (@koalalorenzo)
- [ ] Charity Engine (@Rytiss, @tristanolive)
- [ ] Fission (@bmann)
Things are looking good on our end. We've been running this on a segment of our infrastructure and there are no issues to report as of yet.
tracking orbit-db support: https://github.com/orbitdb/orbit-db/issues/909
Any thoughts on #8413 ? Seems like an easy add with a big usability improvement.
Per 2021-09-09 verbal:
@Jorropo:
8177 pls ?
This won't make it in this release
@kallisti5:
Any thoughts on #8413 ? Seems like an easy add with a big usability improvement.
This won't make it in this release
Just published RC2 on github, dist.ipfs.io, NPM and dockerhub.
:point_right: We are planning to ship the final release around Thursday 30th (TBD), mind the window for testing is a bit short.
ipfs dag get
and ipfs dag put
dag pub/get
easier with no surface for ambiguityipfs multibase transcode --help
ipfs swarm peering --help
ipfs dag import --stats
Early testers β ping for v0.10.0-rc2
testing π
Would it be reasonable to include this merkledag fix ?
tests are passing locally using https://github.com/orbitdb/orbit-db/issues/913 (will be merged and published very soon) + go-ipfs@0.10.0-rc2. :+1:
@MichaelMure IIUC that fix doesn't effect really effect the go-ipfs binary, but might be useful in some edge cases with go-ipfs as a library.
If so then we can do a go-merkledag release. I'd prefer not to add much more into the release if we can to expedite getting it out.
If there's a more pressing need or problem that I'm missing lmk (here, on the go-merkeldag PR, or in a DM)
perhaps https://docs.ipfs.io/install/command-line/#official-distributions could be updated to reference the 0.10 release
Good catch @eminence! I've opened https://github.com/ipfs/ipfs-docs/pull/904 but this is a good candidate for automation (or adding a special 'latest' dir to dist.ipfs.io releases).
go-ipfs 0.10.0 Release
We're happy to announce go-ipfs 0.10.0. This release brings some big changes to the IPLD internals of go-ipfs that make working with non-UnixFS DAGs easier than ever. There are also a variety of new commands and configuration options available.
As usual, this release includes important fixes, some of which may be critical for security. Unless the fix addresses a bug being exploited in the wild, the fix will not be called out in the release notes. Please make sure to update ASAP. See our release process for details.
π TLDR: BREAKING CHANGES
ipfs dag get
dag-json
dag-pb
objects returned bydag get
ipfs dag put
dag-json
, and data is serialized todag-cbor
at rest.--format
and--input-enc
were removed and replaced with--store-codec
and--input-codec
dag-pb
objects stored viadag put
Keep reading to learn more details.
π¦ Highlights
π² IPLD Levels Up
The handling of data serialization as well as many aspects of DAG traversal and pathing have been migrated from older libraries, including go-merkledag and go-ipld-format to the new go-ipld-prime library and its components. This allows us to use many of the newer tools afforded by go-ipld-prime, stricter and more uniform codec implementations, support for additional (pluggable) codecs, and some minor performance improvements.
This is significant refactor of a core component that touches many parts of IPFS, and does come with some breaking changes:
PluginIPLD
interface has been changed to utilize go-ipld-prime. There is a demonstration of the change in the bundled git plugin.dag put
anddag get
change:dag get
now takes theoutput-codec
option which accepts a multicodec name used to encode the output. By default this isdag-json
, which is a strict and deterministic subset of JSON created by the IPLD team. Users may notice differences from the previously plain Go JSON output, particularly where bytes are concerned which are now encoded using a form similar to CIDs:{"/":{"bytes":"unpadded-base64-bytes"}}
rather than the previously Go-specific plain padded base64 string. See the dag-json specification for an explanation of these forms.dag get
no longer prints an additional new-line character at the end of the encoded block output. This means that the output as presented bydag get
are the exact bytes of the requested node. A round-trip of such bytes back in throughdag put
using the same codec should result in the same CID.dag put
uses theinput-codec
option to specify the multicodec name of the format data is being provided in, and thestore-codec
option to specify the multicodec name of the format the data should be stored in at rest. These formerly defaulted tojson
andcbor
respectively. They now default todag-json
anddag-cbor
respectively but may be changed to any supported codec (bundled or loaded via plugin) by its multicodec name.json
andcbor
multicodec names (as used byinput-enc
andformat
options) are now no longer aliases fordag-json
anddag-cbor
respectively. Instead, they now refer to their proper multicodec types.cbor
refers to a plain CBOR format, which will not encode CIDs and does not have strict deterministic encoding rules.json
is a plain JSON format, which also won't encode CIDs and will encode bytes in the Go-specific padded base64 string format rather than the dag-json method of byte encoding. See https://ipld.io/specs/codecs/ for more information on IPLD codecs.protobuf
is no longer used as the codec name fordag-pb
raw
is used to mean Bytes in the IPLD Data Modeldag
API in a form that mirrors the protobuf schema used to define the binary format. This unifies the implementations and specification of dag-pb across the IPLD and IPFS stacks. Previously, additional layers of code for file and directory handling within IPFS between protobuf serialization and UnixFS obscured the protobuf representation. Much of this code has now been replaced and there are fewer layers of transformation. This means that interacting with dag-pb data via thedag
API will use different forms:dag get
on a dag-pb block would present the block serialized as JSON as{"data":"padded-base64-bytes","links":[{"Name":"foo","Size":100,"Cid":{"/":"Qm..."}},...]}
.{"Data":{"/":{"bytes":"unpadded-base64-bytes"}},"Links":[{"Name":"foo","Tsize":100,"Hash":{"/":"Qm..."}},...]}
. Aside from the change in byte formatting, most field names have changed:data
βData
,links
βLinks
,Size
βTsize
,Cid
βHash
. Note that this output can be changed now using theoutput-codec
option to specify an alternative codec.dag put
and astore-codec
option ofdag-pb
now requires that the input conform to this dag-pb specified form. Previously, input using{"data":"...","links":[...]}
was accepted, now it must be{"Data":"...","Links":[...]}
.dag get QmFoo/NamedLink
whereNamedLink
was one of the links whose name wasNamedLink
. This functionality remains the same, but by prefixing the path with/ipld/
we enter data model pathing semantics and candag get /ipld/QmFoo/Links/0/Hash
to navigate to links or/ipld/QmFoo/Data
to simply retrieve the data section of the node, for example.β Multibase Command
go-ipfs now provides utility commands for working with multibase:
See
ipfs multibase --help
for more examples.π¨ Bitswap now supports greater configurability
This release adds an
Internal
section to the configuration file that is designed to help advanced users optimize their setups without needing a custom binary. TheInternal
section is not guaranteed to be the same from release to release and may not be covered by migrations. If you use theInternal
section you should be making sure to check the config documentation between releases for any changes.π Programmatic shell completions command
ipfs commands completion bash
will generate a bash completion script for go-ipfs commandsπ Profile collection command
Performance profiles can now be collected using
ipfs diag profile
. If you need to do some debugging or have an issue to submit the collected profiles are very useful to have around.π Mac OS notarized binaries
The go-ipfs and related migration binaries (for both Intel and Apple Sillicon) are now signed and notarized to make Mac OS installation easier.
π¨βπ©βπ¦ Improved MDNS
There is a completed implementation of the revised libp2p MDNS spec. This should result in better MDNS discovery and better local/offline operation as a result.
π CAR import statistics
dag import
command now supports--stats
option which will include the number of imported blocks and their total size in the output.πΈ Peering command
This release adds
swarm peering
command for easy management of the peering subsystem. Peer in the peering subsystem is maintained to be connected at all times, and gets reconnected on disconnect with a back-off.See
ipfs swarm peering --help
for more details.β Release Checklist
For each RC published in each stage:
version.go
has been updated (in therelease-vX.Y.Z
branch).vX.Y.Z-rcN
Checklist:
release-vX.Y.Z
) frommaster
and make any further release related changes to this branch. If any "non-trivial" changes (see the footnotes of docs/releases.md for a definition) get added to the release, uncheck all the checkboxes and return to this stage.version.go
in themaster
branch tovX.(Y+1).0-dev
.make test
)make test_go_lint
)./bin/mkreleaselog
to generate a nice starter listversion.go
has been updated.release-vX.Y.Z
into therelease
branch.release
branch) withvX.Y.Z
.release
branch back intomaster
, ignoring the changes toversion.go
(keep the-dev
version from master).βοΈ Do you have questions?
The best place to ask your questions about IPFS, how it works and what you can do with it is at discuss.ipfs.io. We are also available at the
#lobby:ipfs.io
Matrix channel which is bridged with other chat platforms.