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

DOC-287 Mountable TS topics #725

Merged
merged 31 commits into from
Oct 30, 2024
Merged

DOC-287 Mountable TS topics #725

merged 31 commits into from
Oct 30, 2024

Conversation

kbatuigas
Copy link
Contributor

@kbatuigas kbatuigas commented Aug 27, 2024

Description

Resolves https://github.com/redpanda-data/documentation-private/issues/2504
Related: Migrations API reference

Review deadline: 9 Oct.

Page previews

24.3 beta: Mountable Topics

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

Copy link

netlify bot commented Aug 27, 2024

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit dd57b3f
🔍 Latest deploy log https://app.netlify.com/sites/redpanda-docs-preview/deploys/67228e1982825f0009dcf0fc
😎 Deploy Preview https://deploy-preview-725--redpanda-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.


. Enable xref:manage:tiered-storage.adoc[Tiered Storage] for specific topics, or for the entire cluster (all topics).
. xref:get-started:rpk-install.adoc[Install `rpk`], or ensure that you have access to the Admin API.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Are there any limitations that users should know about? For example, number of topics you can include in a migration? Amount of time that a topic can "hibernate" in object storage until it is mounted (although maybe that's more to do with their object storage configuration)?

Choose a reason for hiding this comment

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

I'm not aware of any limitations like this. I've successfully ran it with as many topics and partitions as I had no problems to create.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@bashtanov I saw in the rpk PR that a topic must have at least 3 partitions for it to be mounted from TS to a cluster, does that apply anywhere in this doc as well?

Choose a reason for hiding this comment

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

I never enforced or even heard about this restriction

Copy link
Contributor

@gene-redpanda gene-redpanda Oct 14, 2024

Choose a reason for hiding this comment

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

I saw that in the RFC for migrations, no idea if it is actually true as the testing at the time I wrote that was against a version of migrations that wasn't actually working.

@kbatuigas kbatuigas changed the title [draft] Mountable TS topics [do not merge] Mountable TS topics Aug 30, 2024
@kbatuigas kbatuigas mentioned this pull request Oct 5, 2024
4 tasks
@kbatuigas kbatuigas changed the base branch from main to v-WIP/24.3 October 5, 2024 17:22
@kbatuigas kbatuigas changed the title [do not merge] Mountable TS topics Mountable TS topics Oct 7, 2024
@kbatuigas kbatuigas marked this pull request as ready for review October 7, 2024 17:21
@kbatuigas kbatuigas requested a review from a team as a code owner October 7, 2024 17:21
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved

| `executing`
| The cluster rejects client reads and writes for the topics. Redpanda uploads any remaining topic data that has not yet been copied to object storage.
| The target cluster starts topic partitions with log segments downloaded from object storage.

Choose a reason for hiding this comment

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

not yet, the cluster just checks the topic data in tiered storage is not mounted by this or any other cluster

Copy link
Contributor Author

@kbatuigas kbatuigas Oct 13, 2024

Choose a reason for hiding this comment

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

not yet, the cluster just checks the topic data in tiered storage is not mounted by this or any other cluster

Can | The target cluster starts topic partitions with log segments downloaded from object storage. be moved to the next row executed? If not I'll delete entirely

Choose a reason for hiding this comment

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

Topic partitions are started in preparing state, but clients are not given access to it. Subsequent stages for a mount are only about mount manifest manipulation and eventually lifting these restrictions. I'm not sure whether log segments are physically downloaded on topic creation or when it is read from/written into, maybe storage team knows.

modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
modules/manage/partials/mountable-topics.adoc Outdated Show resolved Hide resolved
@kbatuigas kbatuigas changed the title Mountable TS topics DOC-287 Mountable TS topics Oct 13, 2024
@kbatuigas kbatuigas merged commit 3e93983 into v-WIP/24.3 Oct 30, 2024
7 checks passed
@kbatuigas kbatuigas deleted the 2504_mountable-ts branch October 30, 2024 19:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants