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

[es] Add content/es/docs/tasks/manage-kubernetes-objects/declarative-… #26407

Merged
merged 8 commits into from
Mar 24, 2021

Conversation

murillodigital
Copy link
Contributor

@murillodigital murillodigital commented Feb 6, 2021

Add content/es/docs/tasks/manage-kubernetes-objects/declarative-config.md

First document in the Tasks | Manage Kubernetes Objects section, localized to Spanish.

Related: #13948

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Feb 6, 2021
@k8s-ci-robot k8s-ci-robot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Feb 6, 2021
…config.md

Signed-off-by: Leonardo Murillo <leonardo@murillodigital.com>
@netlify
Copy link

netlify bot commented Feb 6, 2021

Deploy preview for kubernetes-io-master-staging ready!

Built with commit e6e772c

https://deploy-preview-26407--kubernetes-io-master-staging.netlify.app

@netlify
Copy link

netlify bot commented Feb 6, 2021

Deploy preview for kubernetes-io-master-staging ready!

Built with commit d0c5dbd

https://deploy-preview-26407--kubernetes-io-master-staging.netlify.app

@murillodigital
Copy link
Contributor Author

@raelga echale un ojo si tenés oportunidad.

Copy link
Contributor

@electrocucaracha electrocucaracha left a comment

Choose a reason for hiding this comment

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

Primeras observaciones del documento

* Configuración de objetos declarativa

Acceda [Kubernetes Object Management](/docs/concepts/overview/working-with-objects/object-management/)
para una discusión de las ventajas y desventajas de cada distinto modo de administración.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
para una discusión de las ventajas y desventajas de cada distinto modo de administración.
para una discusión de las ventajas y desventajas de cada modo distinto de administración.


<!-- overview -->
Objetos en Kubernetes pueden ser creados, actualizados y eliminados utilizando
ficheros de configuración almacenados en un directorio. Usando el comando
Copy link
Contributor

Choose a reason for hiding this comment

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

Personalmente prefiero archivos en lugar de ficheros, pero se que eso depende de la region

Suggested change
ficheros de configuración almacenados en un directorio. Usando el comando
archivos de configuración almacenados en un directorio. Usando el comando

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@electrocucaracha en efecto acá en Costa Rica usamos archivos también, sin embargo como te mencionaba en Slack, usaré el termino fichero siguiendo el glosario definido en #13948

Copy link
Member

@raelga raelga Feb 18, 2021

Choose a reason for hiding this comment

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

En la wikipedia se usa archivo y he estado mirando un poco de etimología, y parece que es más adecuada. Al final un fichero es físico es una carpeta donde almacenar archivos. Supongo que se trata de una false friend por la similitud de file y fichero. Además, en la RAE de se considera el uso de fichero como informal.

Actualizo el glosario!

definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
documentos si aún no lo ha hecho:

* [Managing Kubernetes Objects Using Imperative Commands](/docs/tasks/manage-kubernetes-objects/imperative-command/)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* [Managing Kubernetes Objects Using Imperative Commands](/docs/tasks/manage-kubernetes-objects/imperative-command/)
* [Administración de Objetos de Kubernetes usando comandos imperativos](/docs/tasks/manage-kubernetes-objects/imperative-command/)

documentos si aún no lo ha hecho:

* [Managing Kubernetes Objects Using Imperative Commands](/docs/tasks/manage-kubernetes-objects/imperative-command/)
* [Imperative Management of Kubernetes Objects Using Configuration Files](/docs/tasks/manage-kubernetes-objects/imperative-config/)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* [Imperative Management of Kubernetes Objects Using Configuration Files](/docs/tasks/manage-kubernetes-objects/imperative-config/)
* [Administración imperativa de los Objetos de Kubernetes usando archivos de configuración](/docs/tasks/manage-kubernetes-objects/imperative-config/)

A continuación la definición de términos usados en este documento:

- *fichero de configuración de objeto / fichero de configuración*: Un fichero en el
que se define la configuración de un objeto de Kubernetes. Este tema demuestra como
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
que se define la configuración de un objeto de Kubernetes. Este tema demuestra como
que se define la configuración de un objeto de Kubernetes. Este tema muestra como

Únicamente utilice esta opción si está seguro de saber lo que está haciendo..

{{< warning >}}
`kubectl apply --prune` se encuenta aún en alpha, y cambios incompatibles con versiones previas
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
`kubectl apply --prune` se encuenta aún en alpha, y cambios incompatibles con versiones previas
`kubectl apply --prune` se encuentra aún en alpha, y cambios incompatibles con versiones previas


{{< warning >}}
`kubectl apply --prune` se encuenta aún en alpha, y cambios incompatibles con versiones previas
podrían ser introducidos en futuros lanzamientos.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
podrían ser introducidos en futuros lanzamientos.
podrían ser introducidos en lanzamientos futuros.

no intencionalmente.
{{< /warning >}}

Como una alternativa a `kubectl delete`, usted puede usar `kubectl apply`para identificar objetos por ser
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Como una alternativa a `kubectl delete`, usted puede usar `kubectl apply`para identificar objetos por ser
Como una alternativa a `kubectl delete`, puede usar `kubectl apply` para identificar objetos a ser


Como una alternativa a `kubectl delete`, usted puede usar `kubectl apply`para identificar objetos por ser
eliminados, luego de que sus archivos de configuración han sido eliminados del directorio. El commando `apply` con `--prune`
consulta al servidor de API por todos los objetos que coincidan con un grupo de etiquetas, e intenta parear
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
consulta al servidor de API por todos los objetos que coincidan con un grupo de etiquetas, e intenta parear
consulta a la API del servidor por todos los objetos que coincidan con un grupo de etiquetas, e intenta relacionar

Como una alternativa a `kubectl delete`, usted puede usar `kubectl apply`para identificar objetos por ser
eliminados, luego de que sus archivos de configuración han sido eliminados del directorio. El commando `apply` con `--prune`
consulta al servidor de API por todos los objetos que coincidan con un grupo de etiquetas, e intenta parear
la configuración retornada para los objetos activos contra los objetos según sus ficheros de configuración.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
la configuración retornada para los objetos activos contra los objetos según sus ficheros de configuración.
la configuración obtenida de los objetos activos contra los objetos según sus ficheros de configuración.

Copy link
Contributor

@electrocucaracha electrocucaracha left a comment

Choose a reason for hiding this comment

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

Ultimas sugerencias

definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
documentos si aún no lo ha hecho:

* [Administració n de Objetos de Kubernetes usando comandos imperativos](/docs/tasks/manage-kubernetes-objects/imperative-command/)

This comment was marked as resolved.

## Visión general

La configuración de objetos declarativa requiere una comprensión firme de la
definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
Suggested change
definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
definición y configuración de objetos de Kubernetes. Si aún no lo ha hecho, lea y complete los siguientes


La configuración de objetos declarativa requiere una comprensión firme de la
definición y configuración de objetos de Kubernetes. Lea y complete los siguientes
documentos si aún no lo ha hecho:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
documentos si aún no lo ha hecho:
documentos:

```

{{< warning >}}
No es soportado combinar `kubectl apply` con los comandos de configuración imperativa de objetos
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
No es soportado combinar `kubectl apply` con los comandos de configuración imperativa de objetos
No se puede combinar `kubectl apply` con comandos de configuración imperativa de objetos como


## Como eliminar objetos

Hay dos diferentes opciones para eliminar objetos gestionados por `kubectl apply`.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Hay dos diferentes opciones para eliminar objetos gestionados por `kubectl apply`.
Hay dos opciones diferentes para eliminar objetos gestionados por `kubectl apply`.

A partir de Kubernetes 1.5, el unir listas de elementos primitivos no es soportado.

{{< note >}}
La escogencia de estrategia por selecciones para un campo en particular, es controlada
Copy link
Contributor

Choose a reason for hiding this comment

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

escogencia?

kubectl get -f https://k8s.io/examples/application/simple_deployment.yaml -o yaml
```

La salida demuestra que el API Server definió varios campos con los valores por defecto
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
La salida demuestra que el API Server definió varios campos con los valores por defecto
La salida muestra que el servidor de API definió varios campos con los valores por defecto

# ...
```

En una solicitud de patch, los campos definidos a valores por defecto no son re-definidos exceptuando
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
En una solicitud de patch, los campos definidos a valores por defecto no son re-definidos exceptuando
En una solicitud de patch, los campos definidos a valores por defecto no son redefinidos a excepción de


Campos que no aparecen en el fichero de configuración pueden ser limpiados si se define su valor
a `null` y luego se aplica el fichero de configuración.
Para los campos definidos a valores por defecto por el servidor, esto provoca el re establecimiento
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Para los campos definidos a valores por defecto por el servidor, esto provoca el re establecimiento
Para los campos definidos a valores por defecto por el servidor, esto provoca que se restablezca

## Definiendo los selectores para el controlador y las etiquetas de PodTemplate

{{< warning >}}
Actualizar selectores en controladores se desaconseja encarecidamente.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Actualizar selectores en controladores se desaconseja encarecidamente.
Se desaconseja encarecidamente actualizar los selectores en controladores .

@murillodigital
Copy link
Contributor Author

@electrocucaracha todas las recomendaciones han sido aplicadas. Muchísimas gracias por la retroalimentación. cc @raelga

@raelga
Copy link
Member

raelga commented Feb 25, 2021

Gracias @electrocucaracha y @murillodigital, le hecho un vistazo y la publicamos!

@raelga
Copy link
Member

raelga commented Mar 4, 2021

/assign
/uncc @alexbrand

@k8s-ci-robot k8s-ci-robot removed the request for review from alexbrand March 4, 2021 09:54
@murillodigital
Copy link
Contributor Author

@raelga @electrocucaracha friendly reminder de darle la ultima chequeada a este PR, quisiera poder avanzar con otros documentos de la seccion (más chicos que este 😃 )

@raelga
Copy link
Member

raelga commented Mar 17, 2021

Tienes toda la razón, lo siento. 🙇

* Configuración de objetos imperativa
* Configuración de objetos declarativa

Acceda [Kubernetes Object Management](/docs/concepts/overview/working-with-objects/object-management/)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Acceda [Kubernetes Object Management](/docs/concepts/overview/working-with-objects/object-management/)
Acceda a la [Administración de objetos de Kubernetes](/docs/concepts/overview/working-with-objects/object-management/)

kubectl get -f https://k8s.io/examples/application/simple_deployment.yaml -o yaml
```

La salida le demostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
La salida le demostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`
La salida le mostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`

kubectl get -f https://k8s.io/examples/application/simple_deployment.yaml -o yaml
```

La salida le demostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
La salida le demostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`
La salida le mostrará que la anotación `kubectl.kubernetes.io/last-applied-configuration`

kubectl get -f https://k8s.io/examples/application/update_deployment.yaml -o yaml
```

La salida le mostrará los siguienes cambios hechos a la configuración activa:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
La salida le mostrará los siguienes cambios hechos a la configuración activa:
La salida le mostrará los siguientes cambios hechos a la configuración activa:

{{< /warning >}}

{{< warning >}}
Sea cuidadoso o cuidadosa al usar este comando, para evitar eliminar objetos
Copy link
Contributor

Choose a reason for hiding this comment

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

También se podría usar paréntesis

Suggested change
Sea cuidadoso o cuidadosa al usar este comando, para evitar eliminar objetos
Sea cuidadoso(a) al usar este comando, para evitar eliminar objetos

@electrocucaracha
Copy link
Contributor

@raelga @electrocucaracha friendly reminder de darle la ultima chequeada a este PR, quisiera poder avanzar con otros documentos de la seccion (más chicos que este 😃 )

@murillodigital veo que algunas revisiones a los cambios aun no se han aplicado, podrías resolverlos?

@murillodigital
Copy link
Contributor Author

@electrocucaracha todos los cambios que habian recomendado en buena teoria estan atendidos (como podes ver en el "outdated" del comentario), no se si estamos hablando de lo mismo?

image

Por otro lado voy a revisar las nuevas recomendaciones que agregaste, gracias!

@electrocucaracha
Copy link
Contributor

Me parece que se tienen que esconder seleccionando la opción de resuelto

Screen Shot 2021-03-19 at 5 06 02 PM

@murillodigital
Copy link
Contributor Author

Me parece que se tienen que esconder seleccionando la opción de resuelto

No me aparece la opción, creo que solo lo podes hacer vos?

image

@raelga
Copy link
Member

raelga commented Mar 23, 2021

Gracias @murillodigital y perdón por la demora. Y gracias @electrocucaracha por la cuidadosa revisión.

Por mi parte,

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Mar 23, 2021
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

Git tree hash: 964ed1feedc6216172ae3b24abf3b2b82755fa70

@electrocucaracha
Copy link
Contributor

/lgtm
/approve

@murillodigital
Copy link
Contributor Author

@raelga creo que tenes que darle approve de nuevo?

@raelga
Copy link
Member

raelga commented Mar 24, 2021

Debería ser suficiente con @electrocucaracha , ya que ahora también es OWNER. Quizás aplica a las nuevas PRs?

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: electrocucaracha, raelga

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Mar 24, 2021
@k8s-ci-robot k8s-ci-robot merged commit 7839d5f into kubernetes:master Mar 24, 2021
@raelga
Copy link
Member

raelga commented Mar 24, 2021

Publicado @murillodigital, bienvenido a Kubernetes 🎉 🎉

Muchas gracias @electrocucaracha por la detallada revisión. 💙

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/es Issues or PRs related to Spanish language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants