1
0
mirror of https://github.com/minio/docs.git synced 2025-04-27 18:36:56 +03:00

661 Commits

Author SHA1 Message Date
Daryl White
c1bbe71ceb
Adds mc ready to reference docs (#1221)
Closes #1188
2024-05-22 13:52:25 -04:00
Daryl White
9374fb56e4
Aggregate information on deleting objects (#1218)
Creates a new object management page to aggregate information on
deleting objects.
Links to the page from other docs throughout.

Intentionally leaves most delete information where it is in existing
docs.
    
Closes #741
2024-05-17 16:28:45 -04:00
Andrea Longo
1933043f7e
quote the kubectl apply -k command (#1217)
By request, for readability and also apparently it will then work on
other platforms too.

---------

Co-authored-by: Ramon de Klein <mail@ramondeklein.nl>
2024-05-15 14:00:28 -06:00
Rushan
80a28862e7
Fix white-space behaviour of inline code blocks (#1205) 2024-05-13 17:49:12 -04:00
Ravind Kumar
775e99d47b
DOCS-1190: RELEASE.2024-04-18T19-09-19Z (#1215)
Partially addresses #1190 

No staged build unless someone requests it.

# Summary

After some thinking, we've leaned towards just making a note of the
upgrade step and calling it done. We do not typically make extended
discussion of backward-breaking changes at this time, and have no where
to keep that sort of guidance.

Maybe in the future or as part of a larger re-arch we can consider where
we would best keep that kind of guidance.

As far as the rest:

- We are not covering s3zip today, so that's a no-op. We should leave
the ticket open in the event we have bandwidth to document the feature
later
- No changes to Console that need documentation at this time
- Added a quick callout on the warning behavior to the Versioning page
- Metrics v3 is also still In progress, come back to this once the
project is fully baked.
2024-05-10 18:16:49 -04:00
Andrea Longo
2953b54ecd
correct NATS endpoint syntax (#1212)
NATS endpoints should be specified with hostname and port, not a URL. 

Staged

http://192.241.195.202:9000/staging/nats-endpoint-fix/linux/reference/minio-server/settings/notifications/nats.html

http://192.241.195.202:9000/staging/nats-endpoint-fix/linux/administration/monitoring/publish-events-to-nats.html

Fixes https://github.com/miniohq/engineering/issues/1966
2024-05-10 07:36:52 -06:00
Andrea Longo
7013fc3723
Kustomize deployment instructions (#1202)
New page with Kustomize Operator deployment instructions, as a sibling
to the existing Helm page. Includes some matching updates to the Helm
page, for consistency.

Replacing the Krew instructions (numerous locations) will be a separate
PR.

Staged

http://192.241.195.202:9000/staging/DOCS-1125/k8s/operations/install-deploy-manage/deploy-operator-kustomize.html

See also: https://github.com/minio/operator/pull/1947

Fixes https://github.com/minio/docs/issues/1125
2024-05-09 13:11:40 -06:00
Ravind Kumar
64923e3c1b
DOCS-1159: RELEASE.2024-03-15T01-07-19Z (#1211)
Partially addresses #1159 

Excluding Metrics v3 since that work is ongoing, and it's not fully
baked as of yet.

All changes are effectively config level.

Also fixed up some format/hierarchy issues while I was at it.

Staged:

-
http://192.241.195.202:9000/staging/DOCS-1159/linux/reference/minio-server/settings/core.html
-
http://192.241.195.202:9000/staging/DOCS-1159/linux/reference/minio-server/settings/core.html#compression-extensions
-
http://192.241.195.202:9000/staging/DOCS-1159/linux/reference/minio-server/settings/core.html#maximum-object-versions
-
http://192.241.195.202:9000/staging/DOCS-1159/linux/reference/minio-server/settings/storage-class.html#parity-retention-optimization

---------

Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
Co-authored-by: Andrea Longo <feorlen@users.noreply.github.com>
2024-05-09 14:38:07 -04:00
Ravind Kumar
9c8c089342
FIXUP: Existing object replication is on by default (#1206)
# Summary

We some time ago updated bucket replication to perform existing object
replication by default. Not entirely sure when, but long enough that we
can just make the change.

Also fixed one out-of-band syntax error.

# Staged


http://192.241.195.202:9000/staging/REPLFIX/linux/administration/bucket-replication.html#replication-of-existing-objects
2024-05-07 20:41:32 -04:00
Andrea Longo
3399695e18
Remove deprecated heal options, add two trace call types (#1203)
Remove several `mc admin heal` options from the reference docs. These
were previously deprecated and are now hidden.

Also add two `mc admin trace` call types from the same PR, noted in the
relevant GitHub docs: `batch-keyrotation` and `ilm`.

Staged

http://192.241.195.202:9000/staging/DOCS-1029/linux/reference/minio-mc-admin/mc-admin-heal.html

http://192.241.195.202:9000/staging/DOCS-1029/linux/reference/minio-mc-admin/mc-admin-trace.html#mc.admin.trace.-call

Fixes https://github.com/minio/docs/issues/1029
2024-05-06 12:34:08 -06:00
Furkan Sahin
24d445c35a
Replace mc admin console references with mc admin logs (#1198)
mc admin console command is depreciated, users should start using mc
admin logs instead.
2024-05-06 14:31:40 -04:00
Daryl White
7be620fd13
Deprecates the long-dead mc admin console command (#1204)
Corrects most references to point to the current command.

Additional references to deprecated command fixed by PR #1198 .
We should merge 1198 at the same time we merge this one.
2024-05-06 14:30:36 -04:00
Andrea Longo
72e56b4d98
Note that mc support perf suspends other S3 API calls for testing (#1199)
Add information about queuing requests for `drive` and `net` options.

See https://github.com/minio/minio/pull/19634

Staged:

http://192.241.195.202:9000/staging/mc-support-perf-s3-api/linux/reference/minio-mc/mc-support-perf.html#description
2024-05-03 08:13:54 -06:00
Andrea Longo
748f1e075d
Typo in exclusive volume access admonition (#1197)
oops typo
2024-04-25 14:32:39 -04:00
Daryl White
96224468c4
Add concept pages for Scanner and Healing (#1192)
Adds concept pages for healing and the scanner.
Updates other related files for better context.
    
Adds ref links and other related updates.
    
Closes #1168
2024-04-25 14:27:25 -04:00
Daryl White
c676da2376
Adds an admonition for exclusive drive access (#1196)
Admonition added as an include, then put in many files throughout the
docs.
Where it is included, it's the same admonition and text.

It's worth making sure where I placed the include makes sense.

Closes #1186
2024-04-25 14:19:30 -04:00
Daryl White
8b24974faf
Fix remove references (#1195)
@allanrogerr Noticed that our `mc cp` page had references to removing
objects, almost certainly due to a copy/paste error. This fixes those
references.
2024-04-24 15:09:12 -04:00
Allan Roger Reid
85ef20c21a
Fix typos (#1189) 2024-04-17 17:57:48 -04:00
Ravind Kumar
e71bbe9040
Quick Fix: KES Guidance (#1187)
We already state on one page that you cannot undo KES once configured.

This ensures we make that statement on all other relevant pages.

Staged:

-
http://192.241.195.202:9000/staging/QUICKFIX/linux/operations/server-side-encryption.html
- SSE-KMS and SSE-S3 tabs
-
http://192.241.195.202:9000/staging/QUICKFIX/linux/operations/server-side-encryption/configure-minio-kes.html
-
http://192.241.195.202:9000/staging/QUICKFIX/linux/administration/server-side-encryption.html
SSE KMS and SSE-S3 Tabs
-
http://192.241.195.202:9000/staging/QUICKFIX/linux/administration/server-side-encryption/server-side-encryption-sse-kms.html#quickstart
-
http://192.241.195.202:9000/staging/QUICKFIX/linux/administration/server-side-encryption/server-side-encryption-sse-s3.html#quickstart
2024-04-15 14:58:26 -04:00
Daryl White
24dd7edf49
Adding info about the MINIO_OPTS envvar (#1185)
We didn't discuss `MINIO_OPTS` anywhere.
This adds it.
2024-04-12 16:39:52 -04:00
Daryl White
0739fc8e43
Replace dead URL (#1184)
The URL we were using for StartTLS is no longer valid.
This replaces that with a link to the specification that covers StartTLS
and mentions the specific section to go to.
2024-04-12 09:47:37 -04:00
Ravind Kumar
24cde64392 Changing admonition for erasure set to warning 2024-04-11 12:07:23 -04:00
Ravind Kumar
c06a77403e
MinIO Erasure Stripe Size (#1183)
Staged:
http://192.241.195.202:9000/staging/ERASURE_STRIPE_SIZE/linux/reference/minio-server/settings/core.html#erasure-stripe-size

# Overview

We get somewhat frequent inquiries on how to set a stripe size.

We're going to document the option, but heavily emphasize how carefully
this needs to be handled

The defaults are *almost always* the best choice.

We are not going to provide any additional guidance here.

---------

Co-authored-by: Klaus Post <klauspost@gmail.com>
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
2024-04-10 17:46:08 -04:00
Ravind Kumar
f9614765a8 Removing deprecated or irrelevant APIs 2024-04-10 16:50:16 -04:00
Rushan
51a24f92bd
Update top navigation (#1182)
This commit adds the Architecture and Equinix pages to the top
navigation.
2024-04-10 11:09:50 -04:00
Ravind Kumar
e4f76ba1cf
DOCS-1178: Add S3 API Compatibility List (#1180)
Closes #1178 

This covers the S3 APIs which we directly support - reference
minio/minio/cmd/api-router.go

Any APIs which are marked as 'dummy' internally are considered
'unsupported'
Admin APIs are out of scope here
MinIO API extensions are out of scope as well

We are not doing any detailed reference - just pointing out to S3

---------

Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
2024-04-05 17:28:43 -04:00
Daryl White
96c0d232f8
Updates for several releases and issues (#1179)
Updates for server RELEASE.2024-03-30T09-41-56Z
    
- Adds information that SSE-C encrypted objects can now replicate.
    
Closes #1177

- Adds information on operator renewal of tenant certificates
    
Closes #1167

- Corrects a description for `ilm restore` function
    
Closes #1175

Updates for Console release 0.45.0
    
- Removes healing references
- Updates headings and subheadings for the current Console UI
    
Closes #1107
2024-04-05 16:43:32 -04:00
Andrea Longo
005ac5c126
missing changes from PR 1171 (#1176)
Oops did not type something correctly, this should have been included in
https://github.com/minio/docs/pull/1171
2024-04-02 09:21:34 -06:00
Andrea Longo
b0ab2be7ba
New kubectl minio flags (#1171)
New option `--volumes-per-server` for `kubectl minio tenant create` and
`kubectl minio tenant expand`.

Staged


http://192.241.195.202:9000/staging/DOCS-1129-kubectl/k8s/reference/kubectl-minio-plugin/kubectl-minio-tenant-create.html#kubectl.minio.tenant.create.-volumes

http://192.241.195.202:9000/staging/DOCS-1129-kubectl/k8s/reference/kubectl-minio-plugin/kubectl-minio-tenant-expand.html#kubectl.minio.tenant.expand.-volumes

Partly addresses https://github.com/minio/docs/issues/1129
2024-04-01 16:14:09 -06:00
Daryl White
8b5be57ee3
Deprecated command cleanup (#1166)
- removes `mc admin obd` command
- moves `mc admin profile` to deprecated list

closes #1164

- Moves wildcard matching from `mc mirror` to `minio-mc.rst` page and
adds ref links throughout as needed.
2024-03-28 17:13:35 -04:00
Ravind Kumar
ef81b3d357
Server updates (#1173)
## Server release  RELEASE.2024-03-26T22-10-45Z 

- Adding info about node dashboard for Grafana.
- Also updates links to JSON files for other dashboards that were
incorrect.

*no related docs issue*

## Not a server release, but fixes:

- Corrects information about JSON policy file size limits.
- Adds information about limit on tags per object.
    
Closes #1134

## Server RELEASE.2024-03-21T23-13-43Z
    
- Adds new `user` envvar and config for REDIS notifications
- Simplifies and updates discussion of encryption keys for SSE
    
Closes #1169
2024-03-28 17:07:39 -04:00
Ravind Kumar
c9505be39d Revert "MinIO Server releases and other fixes (#1172)"
This reverts commit 2488541cd0d2c22c358684d47e726baf4dfc35a3.
2024-03-27 18:00:59 -04:00
Daryl White
2488541cd0
MinIO Server releases and other fixes (#1172)
## Server release  RELEASE.2024-03-26T22-10-45Z 

- Adding info about node dashboard for Grafana.
- Also updates links to JSON files for other dashboards that were
incorrect.

*no related docs issue*

## Not a server release, but fixes:

- Corrects information about JSON policy file size limits.
- Adds information about limit on tags per object.
    
Closes #1134

## Server RELEASE.2024-03-21T23-13-43Z
    
- Adds new `user` envvar and config for REDIS notifications
- Simplifies and updates discussion of encryption keys for SSE
    
Closes #1169

## Staging info

- [SSE encryption key
simplification](http://192.241.195.202:9000/staging/server-updates/linux/administration/server-side-encryption.html)
- [Node Grafana metrics & JSON
links](http://192.241.195.202:9000/staging/server-updates/linux/operations/monitoring/grafana.html#minio-node-metrics-dashboard)
- [Policy size
limit](http://192.241.195.202:9000/staging/server-updates/linux/administration/identity-access-management/policy-based-access-control.html#policy-document-structure)
- [Object
tagging](http://192.241.195.202:9000/staging/server-updates/linux/administration/object-management.html#object-tagging)
- [mc tag
set](http://192.241.195.202:9000/staging/server-updates/linux/reference/minio-mc/mc-tag-set.html)
- [REDIS
User](http://192.241.195.202:9000/staging/server-updates/linux/reference/minio-server/settings/notifications/redis.html#user)
2024-03-27 17:54:37 -04:00
Andrea Longo
6e52ebf0dd
Clarify mc support inspect usage (#1170)
If a customer's SUBNET issue requires information from `mc support
inspect` we will give them the correct command to run.

Staged:

http://192.241.195.202:9000/staging/mc-support-inspect/linux/reference/minio-mc/mc-support-inspect.html
2024-03-25 16:06:18 -06:00
Andrea Longo
3c2258375b
Add --action for mc undo (#1133)
Document new option for `mc undo` to restrict the command to reverse
either `DELETE` or `PUT` operations, not both.

Staged

http://192.241.195.202:9000/staging/DOCS-1113/linux/reference/minio-mc/mc-undo.html

Fixes https://github.com/minio/docs/issues/1113
2024-03-22 10:15:22 -06:00
Daryl White
6cae178c36
Updates for two mc-releases (#1162)
mc RELEASE.2024-03-07T00-31-49Z

- Adds new mc support upload command.
  
Closes #1152

mc RELEASE.2024-03-03T00-13-08Z

- Adds alias options for replicate add and replicate update
- Adds exclude-bucket flag for mc mirror
    
Closes #1143
2024-03-20 17:12:18 -04:00
Harshavardhana
b7e08de9eb
metrics must show relevant yaml per tab selection (#1163) 2024-03-19 16:38:28 -04:00
Ravind Kumar
a335fd7495 Dropping admonitions, review and revisit later 2024-03-18 15:50:11 -04:00
Daryl White
c29eb489f4
Updates for two mc releases (#1160)
Adds updates for mc RELEASE.2024-02-24T01-33-20Z
    
- New `mc put` command
- New `mc get` command
- New `--expire-all-object-versions` flag for the `mc ilm rule add`
command
- Adds info to the expiration of objects in versioned buckets on the
Object Lifecycle Management page
    
Closes #1140

Adds updates for mc release RELEASE.2024-01-28T16-23-14Z
    
- adds --skip-errors flag to mc mirror
- updates the mc admin service commands
    
Closes #1120
2024-03-18 13:08:59 -04:00
Daryl White
909178a753
Correcting envvar address for redis (#1161)
Corrects the documentation per
https://github.com/minio/minio/issues/19284.
The address should not have the `user:password` as part of it.

This matches the envvar setting for address to what we already had for
the config setting.
2024-03-18 10:01:43 -04:00
Daryl White
3a52f00cb7
Release work for two server releases (#1157)
Release work for Server RELEASE.2024-03-03T17-50-39Z
    
- Adds new NATS config
- Adds new ilm configs
- Adds info on having a KMS auto generate root credentials
 
Closes #1144

Release work for Server RELEASE.2024-03-10T02-53-48Z
    
- Corrects a missing URL excludes line for some builds
- Adds new webhook options
    
Closes #1155

Staged:
- [Webhook
config](http://192.241.195.202:9000/staging/release-work/linux/reference/minio-server/settings/metrics-and-logging.html#envvar.MINIO_AUDIT_WEBHOOK_BATCH_SIZE)
- [NATS
config](http://192.241.195.202:9000/staging/release-work/linux/reference/minio-server/settings/notifications/nats.html#user-credentials-file)
- [Root
credentials](http://192.241.195.202:9000/staging/release-work/linux/operations/install-deploy-manage/deploy-minio-single-node-single-drive.html#create-the-environment-variable-file)
- [ILM
config](http://192.241.195.202:9000/staging/release-work/linux/reference/minio-server/settings/ilm.html)
2024-03-14 17:28:29 -04:00
Rushan
ceb3efbf33 Fix footer img 2024-03-13 22:44:42 -07:00
Allan Roger Reid
417f77a603
Custom deployments are required to edit YAML manually (#1156)
Custom deployments are required to edit YAML manually to fulfill certain
requirements or limitations such as those on resource requests.

Fixes https://github.com/minio/operator/issues/1204

---------

Co-authored-by: Ravind Kumar <ravindk89@gmail.com>
2024-03-13 14:57:56 -07:00
Rushan
7b355d14de
Update top navigation to match the parent site (#1154) 2024-03-13 11:15:57 -04:00
Ravind Kumar
67e81ce2f8
Multiple SERVER Releases (#1141)
MinIO SERVER RELEASE.2024-01-05T22-17-24Z - added new metrics to
github.com/minio/minio for later sync

MinIO SERVER RELEASE.2024-01-28T22-35-53Z - MinIO preallocates memory,
mc update compresses binary in transit MinIO SERVER
RELEASE.2024-02-06T21-36-22Z -

MinIO adds condition key for restricting STS AssumeRoleWithWebIdentity
duration at policy level

Closes #1124 , 

Partially addresses #1116 
Partially Addresses #1105


---------

Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
2024-03-11 10:06:46 -04:00
Daryl White
54584b290c
Adds recommended metrics to Prometheus procedure (#1147)
Partially addresses #1135

To consider:
I added the tabs as part of step 3 of the procedure, but we might want
to consider having a recommended alerts section separate from the
procedure, perhaps above the "Dashboards" heading. Let me know your
thoughts.
2024-03-08 12:29:40 -05:00
Justin Griffin
ba3b7769ee
Doc update for supporting --endpoint arg with Azure remote tier (#1146)
This is the documentation update associated with PR
https://github.com/minio/minio/pull/19188 that adds the support for
expressing the `--endpoint` arg for a custom Azure blog storage backend.
This is useful for targeting Azure Gov Cloud, which has a different URL.

See https://github.com/minio/minio/pull/19188
2024-03-08 11:18:10 -05:00
Daryl White
1ccef6501b
Fix cert directory in TLS doc (#1151)
Quick fix per internal discussion.
2024-03-07 17:25:12 -05:00
Phil Varner
1c0343fac6
Fixes variable placeholders "ACCESS_KEY", "SECRET_KEY", and "SESSION_TOKEN" to consistently use underscore separator. (#1150)
1. Fixes typo of variable placeholder as "SECRET KEY" to "SECRET_KEY"
2. Changes all uses of variable placeholders "ACCESS_KEY", "SECRET_KEY",
and "SESSION_TOKEN" to consistently use underscore separator.
2024-03-07 12:39:26 -05:00
Daryl White
fa4e28f78c
Splits the helm chart reference page (#1142)
Internal request to split the Operator and Tenant helm chart into
separate pages.

This adds a replacement link in default-conf to automate updating the
operator version in the URL.
2024-03-06 09:29:08 -05:00