Commit Graph

1273 Commits

Author SHA1 Message Date
Zac Dover
b662f58cdb
Merge pull request #60256 from joscollin/wip-doc-update-key-idea
doc: update Key Idea in cephfs-mirroring.rst

Reviewed-by: Venky Shankar <vshankar@redhat.com>
Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Zac Dover <zac.dover@proton.me>
2024-10-16 15:14:12 +10:00
Casey Bodley
af3625d3d7
Merge pull request #60125 from cbodley/wip-doc-rgw-index-filenames
doc/dev/radosgw: update paths that moved under src/rgw/driver/rados/

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-10-15 12:50:00 -04:00
Jos Collin
629922bf6a
doc: update Key Idea in cephfs-mirroring.rst
Updates the snapdiff feature and it's url.

Signed-off-by: Jos Collin <jcollin@redhat.com>
2024-10-15 20:17:42 +05:30
Zac Dover
95916c9190 doc/dev: remove "Stable Releases and Backports"
Remove mention of "Stable Releases and Backports" from
doc/dev/developer_guide/essentials.rst.

Co-authored-by: Laura Flores <lflores@ibm.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-10-10 22:17:12 +10:00
Casey Bodley
db926acb53 doc/dev/radosgw: update paths that moved under src/rgw/driver/rados/
Signed-off-by: Casey Bodley <cbodley@redhat.com>
2024-10-04 15:31:07 -04:00
Lucian Petrut
bb7d5b62d9 doc: Document the Windows CI job
We're adding a document that describes:

* the steps performed by the Windows CI job
* artifact structure
* frequently asked questions

The document is meant to assist the Ceph developers in investigating
CI failures. This is especially important as the Windows CI job runs
integration tests that would otherwise only be executed by
Teuthology, thus helping catch potential regressions quickly.

Note that the identified regressions are not necessarily Windows
specific, usually affecting Linux builds as well.

Signed-off-by: Lucian Petrut <lpetrut@cloudbasesolutions.com>
2024-09-27 17:48:49 +00:00
Anthony D'Atri
858fcd5bda
Merge pull request #45807 from mchangir/doc-document-random-selection-teuthology-operator
doc/dev/developer_guide/testing_integration_tests: Document the random selection operator
2024-09-16 09:12:36 -04:00
Zac Dover
e7bd4bcdd0 doc/dev: add "activate latest release" RTD step
Add a step to the section called "First Stable Release" that explains
how to activate the latest release in Read the Docs.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-09-06 09:31:47 +10:00
Vallari Agrawal
9bfcb8e17d
doc: update tests-integration-testing-teuthology-workflow.rst
* add "Infrastructure" section.

* move "Naming the ceph-ci branch" section under
   "Getting binaries - Build Ceph". Also mention
   about centos9-only trick.

* in "Teuthology Archives", mention about developer
   playground machines and ceph log files.

Signed-off-by: Vallari Agrawal <val.agl002@gmail.com>
2024-09-01 15:05:41 +05:30
Zac Dover
6edfcabb38
Merge pull request #58410 from bill-scales/erasure_coding_design_document
doc: doc/dev/osd_interals/erasure_coding/enhancements.rst

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
Reviewed-by: Sam Just <sjust@redhat.com>
2024-08-13 12:34:05 +10:00
Bill Scales
f6cf38cd63 doc: doc/dev/osd_internals/erasure_coding/enhancements.rst
Erasure coding enhancements design document

Signed-off-by: Bill Scales <bill_scales@uk.ibm.com>
2024-08-08 11:55:17 +00:00
qn2060
103d65ea67
doc/dev/peering: Change acting set num
This commit updates the peering doc page with the changed [2,1,2] to [3,1,2]

Signed-off-by: qn2060 <qn2060@users.noreply.github.com>
2024-08-07 00:40:42 +08:00
Zac Dover
b81d6af1b4 doc/dev: improve basic-workflow.rst
Make various improvements to doc/dev/developer_guide/basic-workflow.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-07-31 05:24:25 +10:00
Zac Dover
86385b1daf
Merge pull request #58705 from gitkenan/crimsonDocChanges
doc/dev/crimson: making it more user-friendly, re-arranging chapters and fixing typos

Reviewed-by: Matan Breizman <mbreizma@redhat.com>
2024-07-23 04:58:39 +10:00
Zac Dover
f836a76cb7
Merge pull request #58600 from zdover23/wip-doc-2024-07-16-dev-guide-basic-workflow
doc/dev: add formatting to basic workflow

Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-07-23 04:00:49 +10:00
Zac Dover
02d5a6a337 doc/dev_guide: add needs-upgrade-testing label info
Add an explanation of the "needs-upgrade-testing" label and explain when
to use it.

Laura is the true author of this text.

Co-authored-by: Laura Flores <lflores@ibm.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-07-23 01:38:11 +10:00
gitkenan
92fea64c1f doc/dev/crimson: clarify and rearrange for userability
Signed-off-by: gitkenan <kenan.mth@gmail.com>
2024-07-22 15:29:11 +01:00
Paulo E. Castro
3b0360bc2e
doc: Amend dev mailing list subscribe instructions.
Signed-off-by: Paulo E. Castro <pecastro@wormholenet.com>
2024-07-20 17:34:48 +01:00
Radoslaw Zarzynski
58b3ae4982
Merge pull request #57591 from aclamk/wip-aclamk-denc-compat-check
common, os/bluestore: Fix lack of checking for compat on DENC_START

Reviewed-by: Radoslaw Zarzynski <rzarzyns@redhat.com>
2024-07-18 01:52:42 +02:00
Adam Kupczyk
6143b80ef7 include/denc.h: Review fixes
- Added note to release-checklist
- Created specialized DENC_START_OSD_REQID
- Use CEPH_RELEASE_SQUID (19) value

Signed-off-by: Adam Kupczyk <akupczyk@ibm.com>
2024-07-16 13:15:38 +00:00
Zac Dover
4c4063a097 doc/dev: add formatting to basic workflow
Add some formatting to a few sections near the end of
doc/dev/developer_guide_basic-workflow.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-07-16 02:03:37 +10:00
Zac Dover
570797e558 doc/dev: edit "Principles for format change"
Improve "Principles for format change" in doc/dev/encoding.rst. This
commit started as a response to Anthony D'Atri's suggestion here: https://github.com/ceph/ceph/pull/58299/files#r1656985564

Review of this section suggested to me that certain minor English usage
improvements would be of benefit. The numbered lists in this section
could still be made a bit clearer.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-07-14 17:25:23 +10:00
Yuri Weinstein
8761bbe16c docs: removed centos 8 and added squid to the build matrix
Signed-off-by: Yuri Weinstein <yweinste@redhat.com>
2024-07-12 06:42:02 -07:00
N Balachandran
9f43c67a63 doc/dev: Fix typos in encoding.rst
Signed-off-by: N Balachandran <nibalach@redhat.com>
2024-06-27 12:52:09 +05:30
Matan Breizman
35d257bfaa doc/dev/crimson: CPU cores allocation
CPU cores allocation and
add crimson-smp vstart flag

Signed-off-by: Matan Breizman <mbreizma@redhat.com>

Signed-off-by: Matan Breizman <mbreizma@redhat.com>
2024-06-18 17:12:14 +10:00
Zac Dover
5134aeb78b doc/dev: link to ceph.io leads list
Remove the docs.ceph.com list of team leads, and link to the list of
leads on ceph.io.

Fixes: https://tracker.ceph.com/issues/66392

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-06-18 00:39:10 +10:00
Ivo Almeida
e082a4d72d
Merge pull request #57746 from ceph/nodejs-lts-update
mgr/dashboard: update node js version  

Reviewed-by: Nizamudeen A <nia@redhat.com>
2024-06-07 10:23:29 +01:00
Zac Dover
36e09fb689 doc/dev: origin of Labeled Perf Counters
Note that Labeled Perf Counters were introduced in Reef.

Fixes: https://github.com/ceph/ceph/pull/57753#discussion_r1626483732

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-06-05 11:18:46 +10:00
Ivo Almeida
45183620dd mgr/dashboard: update node js version
Fixes: https://tracker.ceph.com/issues/66249

Signed-off-by: Ivo Almeida <ialmeida@redhat.com>
2024-05-29 09:25:19 +01:00
Zac Dover
55e41bc679 doc/dev: add note about intro of perf counters
Add a note to the "perf counter" section of doc/dev/perf_counters.rst
that explains that this feature was introduced in the Reef release of
Ceph. This note will prevent us from accidentally backporting
perf-counter-related PRs to Quincy.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-05-29 02:27:53 +10:00
Rishabh Dave
899c481d40 doc/developer_guide: update doc about installing teuthology
There are 2 more ways to install teuthology. Approach with boostrap
script is easier and more convenient while other approach is more
elaborate but manual, document both of them. Don't delete the currently
documented approach because it lets users install teuthology
conveniently in a custom virtual environment. So, keep all three.

Signed-off-by: Rishabh Dave <ridave@redhat.com>
2024-05-28 19:02:57 +05:30
Dan Mick
7e64c6386e doc/dev/release-process.rst: note new 'project' arguments
Support added to the release scripts (from ceph-build.git) to
work for ceph-iscsi, so 'project' must be passed to these scripts,
and will appear in the prerelease pathnames.  See also
https://github.com/ceph/ceph-build/pull/2243 and
https://github.com/ceph/ceph-container/pull/2210

Signed-off-by: Dan Mick <dan.mick@redhat.com>
2024-05-22 16:14:16 -07:00
Zac Dover
832358b072 doc/dev: s/to asses/to assess/
s/to asses/to assess/ in doc/deve/developer_guide/dash-devel.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-05-12 12:27:23 +10:00
Zac Dover
5ff768dc73 doc/dev: repair broken image
Replace the ".. graphviz" directive with an ".. image" directive that
correctly displays an image where previously an unusably zoomed-in image
appeared.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-19 13:28:54 +10:00
Zac Dover
221d734760 doc/dev: refine "Concepts" 4 of 3
s/PG's PG logs/PG's logs/

re https://github.com/ceph/ceph/pull/56727#discussion_r1553541922

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-06 14:43:16 +10:00
Zac Dover
512e2dc9d5 doc/dev: refine "Concepts" 3 of 3
Refine the third third of the entries in the section "Concepts" in
doc/dev/peering.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-05 16:43:47 +10:00
Zac Dover
7bb35282da doc/dev: refine "Concepts" 2 of 3
Refine the second third of the entries in the section "Concepts" in
doc/dev/peering.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-04 22:53:43 +10:00
Zac Dover
530b11be24 doc/dev: refine "Concepts"
Refine the text in the first third of the entries in the section
"Concepts" in doc/dev/peering.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-03 12:16:11 +10:00
Zac Dover
158b0403bd doc/dev: update leads list
Remove Joao Luis from the list of component leads.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-04-01 11:17:39 +10:00
Yuri Weinstein
9ad0cefd3d
Merge pull request #56572 from ceph/wip-yuriw-release-process-main
doc: added jammy to the supported distro list for quincy

Reviewed-by: Laura Flores <lflores@redhat.com>
Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>
2024-03-30 07:57:37 -07:00
Yuri Weinstein
e06dcdee0c doc: added jammy to the supported distro list for quincy
Signed-off-by: Yuri Weinstein <yweinste@redhat.com>
2024-03-29 08:30:17 -07:00
Zac Dover
57e9427eac doc/dev: update leads list
Update the list of component leads in
doc/dev/developer_guide/essentials.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
2024-03-29 22:28:35 +10:00
Patrick Donnelly
cddb41a8b4
doc: reconcile release checklist
Updating the releases documentation existed already but that section should be
moved to after dev freeze when the branch is forked.

Fixes: 7b5017913a
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-28 18:50:02 -04:00
Patrick Donnelly
7b5017913a
doc: update release checklist
To include note that release notes must be removed after forking the release
branch.

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-28 17:14:13 -04:00
Matan Breizman
f19765ec08
Merge pull request #56173 from Matan-B/wip-matanb-clone-overlap-doc
doc/dev: osd_internals/snaps.rst: add clone_overlap doc

Reviewed-by: Ilya Dryomov <idryomov@gmail.com>
Reviewed-by: Radosław Zarzyński <rzarzyns@redhat.com>
Reviewed-by: Anthony D'Atri <anthonyeleven@users.noreply.github.com>
Reviewed-by: Greg Farnum <gfarnum@redhat.com>
Reviewed-by: Zac Dover <zac.dover@proton.me>
2024-03-25 12:15:22 +02:00
Matan Breizman
6a7f2b0fda doc/dev: osd_internals/snaps.rst: add clone_overlap doc
snapdir concept was removed in: https://github.com/ceph/ceph/pull/17579

Co-authored-by: Zac Dover <zac.dover@proton.me>
Signed-off-by: Matan Breizman <mbreizma@redhat.com>
2024-03-24 12:10:05 +00:00
Patrick Donnelly
719d30d277
doc/dev: update quiesce developer document
To include changes relating to it now being a local lock that prevents mutable
caps.

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-20 10:56:58 -04:00
Patrick Donnelly
51c9b86bf1
doc: add dev docs for quiesce protocol
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-20 10:56:55 -04:00
Patrick Donnelly
a3e541f999
mds: add new inode quiescelock
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-20 10:56:54 -04:00
Patrick Donnelly
7060146d6a
doc/dev: update teuthology priority guidance
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2024-03-14 14:59:23 -04:00