diff options
| author | Julio A. Leyva Osorio <tony931023@gmail.com> | 2021-07-05 05:02:07 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-07-05 11:02:07 +0200 |
| commit | e996716ad4b66b4d40e44123711a738789b9a2b8 (patch) | |
| tree | 9b6022eff479574900f2a54c6dd41bec873e135b /docs | |
| parent | 6117caaaff06d1ec34696cdb66529eb0f2ec825a (diff) | |
| download | wiki-e996716ad4b66b4d40e44123711a738789b9a2b8.tar.gz wiki-e996716ad4b66b4d40e44123711a738789b9a2b8.tar.bz2 wiki-e996716ad4b66b4d40e44123711a738789b9a2b8.zip | |
Chore: Updates and creation of wiki files in Spanish (#572)
* Spanish Update account.md
* Creation of the home.md document in spanish
* Creation of the arch-linux.md document in spanish
* Creation of the aws-tutorial.md document in spanish
* Creation of the bash_system.md document in spanish
* Creation of the best-practices.md document in spanish
* Creation of the file-headers.md document in spanish
* Creation of the core-installation.md document in spanish
* Creation of the bountysource.md document in spanish
* Creation of the contribute.md document in spanish
* Creation of the bit-and-bytes-tutorial.md document in spanish
* Creation of the faq.md document in spanish
* Creation of the how-to-debug.md document in spanish
* Creation of the upgrade-from-pre-2.0.0-to-latest-master.md document in spanish
* Creation of the upgrade-from-pre-3.0.0-to-latest-master.md document in spanish
* Creation of the trinitycore-to-azerothcore-characters-migration.md document in spanish
* Creation of the keeping-the-server-up-to-date.md document in spanish
* Creation of the wiki-standards.md document in spanish
* Creation of the importing-spell-dbc.md document in spanish
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/es/account.md | 63 | ||||
| -rw-r--r-- | docs/es/arch-linux.md | 27 | ||||
| -rw-r--r-- | docs/es/aws-tutorial.md | 284 | ||||
| -rw-r--r-- | docs/es/bash_system.md | 43 | ||||
| -rw-r--r-- | docs/es/best-practices.md | 35 | ||||
| -rw-r--r-- | docs/es/bit-and-bytes-tutorial.md | 286 | ||||
| -rw-r--r-- | docs/es/bountysource.md | 48 | ||||
| -rw-r--r-- | docs/es/contribute.md | 62 | ||||
| -rw-r--r-- | docs/es/core-installation.md | 32 | ||||
| -rw-r--r-- | docs/es/faq.md | 126 | ||||
| -rw-r--r-- | docs/es/file-headers.md | 23 | ||||
| -rw-r--r-- | docs/es/home.md | 44 | ||||
| -rw-r--r-- | docs/es/how-to-debug.md | 1 | ||||
| -rw-r--r-- | docs/es/importing-spell-dbc.md | 19 | ||||
| -rw-r--r-- | docs/es/keeping-the-server-up-to-date.md | 35 | ||||
| -rw-r--r-- | docs/es/trinitycore-to-azerothcore-characters-migration.md | 40 | ||||
| -rw-r--r-- | docs/es/upgrade-from-pre-2.0.0-to-latest-master.md | 27 | ||||
| -rw-r--r-- | docs/es/upgrade-from-pre-3.0.0-to-latest-master.md | 29 | ||||
| -rw-r--r-- | docs/es/wiki-standards.md | 33 |
19 files changed, 1226 insertions, 31 deletions
diff --git a/docs/es/account.md b/docs/es/account.md index 453142f..064a829 100644 --- a/docs/es/account.md +++ b/docs/es/account.md @@ -6,39 +6,40 @@ **Estructura** -| Field | Type | Attributes | Key | Null | Default | Extra | Comment | -| --------------------- | ------------ | ---------- | --- | ---- | ----------------- | -------------- | ---------- | -| [id][1] | INT | UNSIGNED | PRI | NO | | AUTO_INCREMENT | Identifier | -| [username][2] | VARCHAR(32) | | UNI | NO | | | | -| [salt][3] | BINARY(32) | | | NO | | | | -| [verifier][4] | BINARY(32) | | | NO | | | | -| [session_key][5] | BINARY(40) | | | YES | | | | -| [token_key][6] | VARCHAR(100) | | | NO | | | | -| [email][7] | VARCHAR(255) | | | NO | | | | -| [reg_mail][8] | VARCHAR(255) | | | NO | | | | -| [joindate][9] | TIMESTAMP | | | NO | CURRENT_TIMESTAMP | | | -| [last_ip][10] | VARCHAR(15) | | | NO | 127.0.0.1 | | | -| [last_attempt_ip][11] | VARCHAR(15) | | | NO | 127.0.0.1 | | | -| [failed_logins][12] | INT | UNSIGNED | | NO | 0 | | | -| [locked][13] | TINYINT | UNSIGNED | | NO | 0 | | | -| [lock_country][14] | VARCHAR(2) | | | NO | 0 | | | -| [last_login][15] | TIMESTAMP | | | YES | NULL | | | -| [online][16] | INT | UNSIGNED | | NO | 0 | | | -| [expansion][17] | TINYINT | UNSIGNED | | NO | 2 | | | -| [mutetime][18] | BIGINT | SIGNED | | NO | 0 | | | -| [mutereason][19] | VARCHAR(255) | | | NO | | | | -| [muteby][20] | VARCHAR(50) | | | NO | | | | -| [locale][21] | TINYINT | UNSIGNED | | NO | 0 | | | -| [os][22] | VARCHAR(3) | | | NO | | | | -| [recruiter][23] | INT | UNSIGNED | | NO | 0 | | | -| [totaltime][24] | INT | UNSIGNED | | NO | 0 | | | +| Field | Type | Attributes | Key | Null | Default | Extra | Comment | +| --------------------- | ------------- | ---------- | --- | ---- | ----------------- | -------------- | ---------- | +| [id][1] | INT | UNSIGNED | PRI | NO | | AUTO_INCREMENT | Identifier | +| [username][2] | VARCHAR(32) | SIGNED | UNI | NO | '' | | | +| [salt][3] | BINARY(32) | SIGNED | | NO | | | | +| [verifier][4] | BINARY(32) | SIGNED | | NO | | | | +| [session_key][5] | BINARY(40) | SIGNED | | YES | | | | +| [totp_secret][6] | VARBINARY(100)| SIGNED | | YES | | | | +| [email][7] | VARCHAR(255) | SIGNED | | NO | '' | | | +| [reg_mail][8] | VARCHAR(255) | SIGNED | | NO | '' | | | +| [joindate][9] | TIMESTAMP | SIGNED | | NO | CURRENT_TIMESTAMP | | | +| [last_ip][10] | VARCHAR(15) | SIGNED | | NO | 127.0.0.1 | | | +| [last_attempt_ip][11] | VARCHAR(15) | SIGNED | | NO | 127.0.0.1 | | | +| [failed_logins][12] | INT | UNSIGNED | | NO | 0 | | | +| [locked][13] | TINYINT | UNSIGNED | | NO | 0 | | | +| [lock_country][14] | VARCHAR(2) | SIGNED | | NO | 00 | | | +| [last_login][15] | TIMESTAMP | SIGNED | | YES | | | | +| [online][16] | INT | UNSIGNED | | NO | 0 | | | +| [expansion][17] | TINYINT | UNSIGNED | | NO | 2 | | | +| [mutetime][18] | BIGINT | SIGNED | | NO | 0 | | | +| [mutereason][19] | VARCHAR(255) | SIGNED | | NO | '' | | | +| [muteby][20] | VARCHAR(50) | SIGNED | | NO | '' | | | +| [locale][21] | TINYINT | UNSIGNED | | NO | 0 | | | +| [os][22] | VARCHAR(3) | SIGNED | | NO | '' | | | +| [recruiter][23] | INT | UNSIGNED | | NO | 0 | | | +| [totaltime][24] | INT | UNSIGNED | | NO | 0 | | | + [1]: #id [2]: #username [3]: #salt [4]: #verifier [5]: #session_key -[6]: #token_key +[6]: #totp_secret [7]: #email [8]: #reg_mail [9]: #joindate @@ -80,15 +81,15 @@ El verificador se deriva de salt, asà como el nombre de usuario (todo en mayús Para obtener el verificador hay que calcular: -1. Calcule `h1 = SHA1("USUARIO:CONTRASEÑA")`, sustituyendo el nombre de usuario y la contraseña convertidos en mayúsculas. +1. Calcular `h1 = SHA1("USUARIO:CONTRASEÑA")`, sustituyendo el nombre de usuario y la contraseña convertidos en mayúsculas. -2. Calcule `h2 = SHA1(salt || h1)`, dónde || es la concatenación (el operador . en PHP). +2. Calcular `h2 = SHA1(salt || h1)`, dónde || es la concatenación (el operador . en PHP). **NOTA:** ¡Tanto `salt` como `h1` son cadenas binarias, no hexadecimales! 3. Tratar `h2` como un entero en orden little-endian (el primer byte es el menos significativo). -4. Calcule `(g ^ h2) % N`. +4. Calcular `(g ^ h2) % N`. **NOTA:** `g` y `N` son parámetros, que están fijados en la implementación de WoW. @@ -112,7 +113,7 @@ Para obtener el verificador hay que calcular: `campo-sin-descripción|5` -### token_key +### totp_secret La clave del autentificador. diff --git a/docs/es/arch-linux.md b/docs/es/arch-linux.md new file mode 100644 index 0000000..c239658 --- /dev/null +++ b/docs/es/arch-linux.md @@ -0,0 +1,27 @@ +# Instalación de Arch Linux +Si es un usuario de Arch Linux, puede instalarlo desde AUR ([Arch User Repository](https://wiki.archlinux.org/index.php/Arch_User_Repository)) + +## Instalar dependencias + +### Instalar *base-devel* +Todo lo que necesita para instalar los paquetes AUR es [*base-devel*](https://www.archlinux.org/groups/x86_64/base-devel/) and [*git*](https://www.archlinux.org/packages/?name=git), puede instalarlos con *pacman*: +``` +$ sudo pacman -S base-devel git +``` + +### Instalar *ACE* +Debe instalar el paquete [*ACE*](https://aur.archlinux.org/packages/ace/) de AUR: +``` +git clone https://aur.archlinux.org/ace.git +cd ace +makepkg -si +``` +## Instalar *AzerothCore* +Después de eso, puedes instalar el paquete [azerothcore](https://aur.archlinux.org/packages/azerothcore/) : + +``` +git clone https://aur.archlinux.org/azerothcore.git +cd azerothcore +makepkg -si +``` +Además, si lo desea, puede usar [*yay*](https://github.com/Jguer/yay) como administrador de paquetes AUR para instalar paquetes AUR. diff --git a/docs/es/aws-tutorial.md b/docs/es/aws-tutorial.md new file mode 100644 index 0000000..0d88b72 --- /dev/null +++ b/docs/es/aws-tutorial.md @@ -0,0 +1,284 @@ +# Hospedaje de AzerothCore a través de Amazon AWS + +Prefacio: El objetivo de esta guÃa es que se realice principalmente a través de una lÃnea de comandos. También existe la [Consola de AWS] (https://aws.amazon.com/console/) que algunos encontrarán más intuitiva, sin embargo, para la longevidad de la guÃa (ya que la interfaz de usuario de la Consola de AWS puede cambiar), la herramienta aws-cli será recomendado. También se incluirán comandos grep para recibir solo la salida requerida. Si desea obtener la salida completa, simplemente elimine el `| grep` y todo lo que le sigue. + +------ + +[TOC] + +------ + +## Requisitos previos + +Estas herramientas son necesarias ya que el resto del tutorial se realizará a través de una lÃnea de comando habilitada para bash: + +- [Cuenta de Amazon AWS](https://portal.aws.amazon.com/billing/signup#/start) +- [Git](https://git-scm.com/downloads) +- [Python](https://www.python.org/downloads/) - asegúrese de verificar que esto se agregue a PATH si usa Windows + +------ + +## AWS-CLI + +### Instalación de AWS-CLI + +En primer lugar, verifique que Python y su herramienta pip incluida estén configurados correctamente: + +```bash +python --version && pip --version +``` + +Esto deberÃa devolver tanto la versión de python como la de pip. Si no es asÃ, instale Python correctamente y vincúlelo a la RUTA. Ahora que Python está instalado, instale aws-cli a través de: + +```bash +pip install awscli --upgrade +``` + +Verifique que awscli se haya instalado correctamente ingresando `aws --version`. Si no se instaló correctamente, consulte [esto] (https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html#install-post) para solucionar el problema según el funcionamiento del sistema operativo de su computadora. + +### Configuración de AWS-CLI + +Se requerirá una clave de acceso y una identificación. Esto se puede encontrar en [Credenciales de seguridad de AWS] (https://console.aws.amazon.com/iam/home#/security_credentials) y seleccionando el botón Claves de acceso> Crear nueva clave de acceso. ** Mantenga esta clave segura, ya que puede usarse para realizar cualquier acción en una cuenta de AWS **. Se considera una buena práctica permitir el acceso a través de un [Usuario de IAM] (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html), especialmente si los privilegios de AWS se compartirán con otra persona. Una vez que se haya obtenido la clave, úsela para otorgar credenciales a aws-cli usando el comando: + +```bash +aws configure +``` + +Inserte el ID y la clave en sus campos correspondientes. Para el nombre de región predeterminado, inserte `us-east-1` y para el formato de salida predeterminado inserte` table`. Ahora se puede encontrar otro servidor con el comando: + +```bash +aws ec2 describe-regions --output table +``` + +Utilice el comando `ping` más los distintos puntos finales para probar la latencia en las regiones. Después de encontrar un servidor apropiado, ejecute `aws configure` nuevamente e ingrese a la nueva región. + +### Creación de un par de claves + +Antes de que se creen instancias de servidor, se requerirá un [par de claves](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html). Este par de claves se utilizará para validar el acceso a las instancias EC2 a las que está adherido. Cree un nuevo par de claves a través de: + +```bash +aws ec2 create-key-pair --key-name AzCore-KP --query 'KeyMaterial' --output text > ~/AzCore-KP.pem +``` + +El par de claves se guardará en el directorio $HOME. Asegúrese de mantener seguro este archivo `AzCore-KP.pem` recién creado, ya que ** este archivo no se puede rehacer ** después de su creación. Si el par de claves se pierde después de vincularlo a cualquier instancia EC2, será necesario rehacerlo con un nuevo par de claves. El par de claves se utiliza para SSH en la instancia y no hay forma de eliminar el acceso del par de claves sin eliminar finalmente la instancia EC2. Antes de que se pueda utilizar el par de claves, los permisos deben establecerse con: + +```bash +chmod 400 ~/AzCore-KP.pem +``` + +### Creación de una VPC + +*Nota: Aunque AWS proporciona una VPC predeterminada que funcionará bien. La información necesaria para crear una VPC completamente nueva para esta guÃa se proporcionará en caso de que la VPC predeterminada para cualquier caso no esté disponible o no funcione. Al mismo tiempo, actúa como una exploración más profunda de AWS y sus funciones de red.* + +Creando una VPC para la región usando: + +```bash +aws ec2 create-vpc --cidr-block 172.32.0.0/16 | grep -Po "(vpc)-[a-zA-Z0-9]*\s" +``` + +Esto deberÃa generar el vpc-id. Guárdelo ya que será necesario más adelante. + +También se necesita el comando: + +```bash +aws ec2 modify-vpc-attribute --enable-dns-hostnames --vpc-id $VPC_ID +``` + +### Creación de una subred + +Es necesario vincular una subred con la VPC mediante: + +```bash +aws ec2 create-subnet --cidr-block 172.32.0.0/20 --vpc-id $VPC_ID | grep -Po "(?<!\/)(subnet)-[a-zA-Z0-9]*\s" +``` + +Guarde el valor del ID de subred para usarlo más adelante. + +### Creación de una puerta de enlace a Internet + +Cree y conecte la puerta de enlace de Internet con: + +```bash +aws ec2 create-internet-gateway | grep -Po "(igw)-[a-zA-Z0-9]*\s" +aws ec2 attach-internet-gateway --internet-gateway-id $IGW_ID --vpc-id $VPC_ID +``` + +### Creación de una tabla de ruta + +La VPC recién creada viene con una tabla de rutas incluida, sin embargo, no tiene acceso a una puerta de enlace de Internet de forma predeterminada. Para solucionar este problema, describa las tablas de enrutamiento con: + +```bash +aws ec2 describe-route-tables +``` + +Esto devolverá una tabla con todas las VPC de la región. Busque el que tenga el bloque CIDR utilizado, que probablemente sea `172.32.0.0/16` y guarde el valor de` RouteTableID`. Después de encontrar la identificación de la tabla de ruta, ingrese: + +```bash +aws ec2 create-route --route-table-id $RouteTableID --destination-cidr-block 0.0.0.0/0 --gateway-id $IGW_ID +``` + +### Creación de un Grupo de Seguridad + +El grupo de seguridad proporcionará acceso a los puertos necesarios para el tráfico al servidor. Esto se hace mediante: + +```bash +aws ec2 create-security-group --group-name AzerothCore --description "World / Auth / SSH Port Access" --vpc-id $VPC_ID | grep -Po "(sg)-[a-zA-Z0-9]*\s" +``` + +### Configuración del Grupo de Seguridad + +La siguiente cadena crea los permisos de tráfico de puertos que permiten el tráfico en los puertos 22 (SSH), 8085 (World Server) y 3724 (Authentication Server). Donde $SECURITY_GROUP_ID es la salida obtenida previamente. + +```bash +aws ec2 authorize-security-group-ingress --group-id $SECURITY_GROUP_ID --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,IpRanges='[{CidrIp=0.0.0.0/0, Description="SSH from Anywhere"}]' IpProtocol=tcp,FromPort=8085,ToPort=8085,IpRanges='[{CidrIp=0.0.0.0/0, Description="World-Server from Anywhere"}]' IpProtocol=tcp,FromPort=3724,ToPort=3724,IpRanges='[{CidrIp=0.0.0.0/0, Description="Auth-Server from Anywhere"}]' +``` + +### Encontrar una AMI + + [Ubuntu 18.04 LTS](https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-024a64a6685d05041) se utilizará para la guÃa, pero cualquier distribución de Linux deberÃa estar bien. Tenga en cuenta que puede haber pequeñas idiosincrasias con distribuciones diferentes. Se pueden encontrar versiones de AMI más recientes de Ubuntu [aquÃ](https://cloud-images.ubuntu.com/locator/ec2/) y otras AMI que se encuentran en [AWS Marketplace](https://aws.amazon.com/marketplace/ref=csl_ec2_ami). La AMI que se utiliza para la guÃa es `ami-024a64a6685d05041`. Encuentre más información sobre esta imagen con: + +```bash +aws ec2 describe-images --image-ids ami-024a64a6685d05041 +``` + +### Ejecutando la Instancia + +Ahora es el momento de crear la instancia del servidor. Inserte la AMI descrita anteriormente o una nueva en lugar de $AMI_ID : + +```bash +aws ec2 run-instances --image-id $AMI_ID --instance-type t2.micro --count 1 --associate-public-ip-address --key-name AzCore-KP --security-group-ids $SECURITY_GROUP_ID --subnet-id $SUBNET_ID +``` + +Esto creará e inicializará una instancia t2.micro. *Solo se puede ejecutar constantemente una instancia en un mes sin pagar por horas de servidor adicionales.* + +### Modificar el Volumen + +Ahora, describe la instancia en ejecución con: + +```bash +aws ec2 describe-instances +``` + +Busque la instancia en ejecución y ejecute el siguiente comando en el ID de volumen adjunto: + +```bash +aws ec2 modify-volume --size 20 --volume-id $VOL_ID +``` + +*Esto cambiará el almacenamiento a 20GB. 30GB es el almacenamiento en bloque MAX para el nivel gratuito. ¡Trate de no pasar por alto eso a menos que tenga la intención de pagar!* + +### Asignación de una IP Estática + +Ejecute el comando: + +```bash +aws ec2 allocate-address --domain $VPC_ID +``` + +Esto proporcionará un ID de asignación. Ahora, usando el ID de instancia que se puede encontrar en el `aws ec2 describe-instances` ejecutado anteriormente, ejecute el comando: + +```bash +aws ec2 associate-address --allocation-id $ALLOC_ID --instance-id $INSTANCE_ID +``` + +*Si se desea un dominio para la conexión, considere el servicio [Amazons Route 53] (https://aws.amazon.com/route53/). Se pueden encontrar a tan solo 12$ por año.* + +------ + +## La Instancia + +### SSH en la instancia + +Describe la instancia con `aws ec2 describe-instances` y busca el `PublicDnsName`. + +Accede al servidor usando el comando: + +```bash +SSH -i "~/AzCore-KP.pem" ubuntu@$PublicDnsName +``` + +### Instalación de AzerothCore + +Siga la parte de Linux de la guÃa que se encuentra en <http://www.azerothcore.org/wiki/Installation>. Ejecute `sudo apt-get update && sudo apt-get upgrade` antes de instalar las dependencias y actualizar los parches de seguridad. + +### Subiendo archivo de datos al servidor + +Descargue [newest_data.zip](https://mega.nz/#F!Am4DBKCR!o9Qj_xFLfsg4sczqg0xq2A) y descomprÃmalo y sus subcarpetas. Luego `cd` en la carpeta donde se encuentra y ejecute el comando: + +```bash +tar zcfv ~/data.tar.gz newest_data/ +``` + +Esto comprimirá el archivo en un archivo tar.gz. Ahora para subirlo al servidor usando + +```bash +scp -i "~/AzCore-KP.pem" ~/data.tar.gz ubuntu@$PublicDnsName:$CMAKE_INSTALL_PREFIX/data +``` + +Esto puede llevar un tiempo dependiendo de la velocidad de carga. $CMAKE_INSTALL_PREFIX será la ruta hacia donde está instalado el servidor, no el repositorio git clonado que es `~/azeroth-server/` por defecto. + +Ahora descomprÃmelo con: + +```bas +tar xfv $CMAKE_INSTALL_PREFIX/data.tar.gz --strip-components=2 +``` + +Ahora deberÃa descomprimirse en `$CMAKE_INSTALL_PREFIX/data/` + +Alternativamente, tomado de [stackoverflow](https://stackoverflow.com/a/49444877) y con un rendimiento de descarga mucho mejor: + +```bash +#!/bin/bash +fileid="12XIh3rqm3ukpSKQtMop44U4XCYb6kdda" +filename="data.tar.gz" +curl -c ./cookie -s -L "https://drive.google.com/uc?export=download&id=${fileid}" > /dev/null +curl -Lb ./cookie "https://drive.google.com/uc?export=download&confirm=`awk '/download/ {print $NF}' ./cookie`&id=${fileid}" -o ${filename} +``` + +Ejecute `nano $CMAKEINSTALL_PREFIX/data/` y guarde este script como un archivo .`sh` en el directorio de datos y ejecute `chmod -x $filename.sh` para hacerlo ejecutable. El script descargará un [newest_data](https://mega.nz/#F!Am4DBKCR!o9Qj_xFLfsg4sczqg0xq2A) desde Google Drive [upload](https://drive.google.com/open?id=12XIh3rqm3ukpSKQtMop44U4XCYb6kdda). *nota: recomiendo verificar que los valores de la suma de comprobación SHA256 coincidan entre la carga mega y la carga de la unidad de Google. De lo contrario, los archivos no se manipulan ni se modifican.* + + +### Configuración de la base de datos + +Ingrese a MySQL usando `sudo mysql`. Se necesitará un nombre de usuario y contraseña para acceder a la base de datos. + +```sql +GRANT ALL PRIVILEGES ON *.* TO 'username'@'localhost' IDENTIFIED BY 'password'; +``` + +Los archivos .conf deberán editarse con el nombre de usuario y la contraseña recién elegidos que se describen [aquÃ](http://www.azerothcore.org/wiki/Installation#4-setting-the-configuration-files). + +### Problema de Kswapd + +*Nota: si se ejecuta en una instancia más potente, este paso probablemente sea irrelevante. Para la instancia t2.micro con 1 GB de RAM, se requiere este paso.* + +Como ejercicio de aprendizaje después de la compilación, ejecute un `top -oh% MEM` e intente iniciar el servidor mundial. Eventualmente, se cortará y el servidor dejará de responder. Observe que el proceso que ocupa la mayor parte de la memoria es `kswapd`. El proceso `kswapd` se usa siempre que el uso de la memoria del sistema alcanza un umbral y luego descarga la memoria en un almacenamiento. Sin embargo, la imagen de intercambio predeterminada no asigna suficientes recursos para ejecutar el servidor mundial, por lo que se necesita uno nuevo. [Aquà se pueden encontrar varias soluciones a este problema.] (Https://askubuntu.com/questions/178712/how-to-increase-swap-space) La guÃa utilizará el [método] `dd` (https: //askubuntu.com/a/178726): + +```Bash +#Crea una imagen de intercambio de 3GB y configura un área de intercambio +sudo dd if=/dev/zero of=/media/fasthdd/swapfile.img bs=1024 count=3M +sudo mkswap /media/fasthdd/swapfile.img + +#Abre el editor con permisos sudo en /etc/fstab +sudo nano /etc/fstab + +# Agregue esta lÃnea a /etc/fstab +/media/fasthdd/swapfile.img swap swap sw 0 0 + +#Activar la imagen de intercambio +swapon /media/fasthdd/swapfile.img +``` + +### Conectando al servidor + +Busque las instancias Dirección IP pública que se puede encontrar con `aws ec2 describe-instances`. Ingrese el `PublicIpAddress` en su tabla de realmlist` acore_auth`. Puede encontrar más información de conexión [aquÃ] (http://www.azerothcore.org/wiki/Installation#8-connecting-to-the-server). + +------ + +## Descargo de responsabilidad + +​ Muchas de las mejores prácticas no se han seguido en lugar de la brevedad de la guÃa y la ignorancia general sobre la seguridad de Internet. Algunas cosas que se deben saber y que deben hacerse si planea permitir que cualquier persona acceda a su servidor incluyen: + +- [Agregar un usuario de IAM para cualquier persona que necesite acceso a AWS.] (Https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) *No permita que alguien ejecute 100 instancias para extraer bitcoins ... tenga en cuenta que la información de pago se almacena para crear una cuenta y que AWS cobra por hora de servidor utilizada.* **Sea seguro.** +- La capa gratuita de AWS permite ** 750 ** horas de instancia, lo que significa 750/24 = 31,25 dÃas. *Solo se puede ejecutar una instancia ininterrumpida durante un mes sin pagar y el nivel gratuito solo dura 12 meses después de la creación de la cuenta. No reciba cargos no intencionales. ¡Has sido advertido!* +- Por lo general, no permita SSH o privilegios de administrador a otro usuario hasta que haya investigado un poco sobre cómo proteger Linux y no permita a nadie privilegios de root. Solo permita a los usuarios los privilegios mÃnimos requeridos. Tu seguridad está en tus manos, ¡buena suerte! diff --git a/docs/es/bash_system.md b/docs/es/bash_system.md new file mode 100644 index 0000000..6bb1974 --- /dev/null +++ b/docs/es/bash_system.md @@ -0,0 +1,43 @@ +# Sistema BASH + +AzerothCore utiliza un sistema bash avanzado que nos permite automatizar procesos como la **compilación de fuentes, la instalación de módulos, la configuración de la base de datos, etc.** + +Por ahora, estamos usando bash en lugar de Python para reducir las dependencias externas, ya que BASH es un lenguaje de scripting multiplataforma que ya está incluido. +con ** OSX, Linux y Windows ** (a través de GIT BASH que le pedimos que instale en nuestros requisitos). + +Puede leer la documentación oficial de bash aquí: https://tldp.org/LDP/abs/html/index.html + +## Panel ACORE + +Nuestros scripts de bash relacionados con azerothcore se pueden encontrar dentro de la carpeta /app, pero también creamos un script llamado **acore.sh** dentro de la carpeta raíz. +Este script ejecuta un panel que contiene los comandos para ejecutar todos los scripts relacionados con la carpeta /app. + +run `./acore.sh --help` para ver la lista completa de los comandos disponibles. + +### Configuración + +La carpeta /conf disponible en el directorio raíz de nuestro proyecto se utiliza para darle la posibilidad de cambiar las configuraciones de todos nuestros scripts bash. + +### Modo interactivo + +ejecute `./acore.sh` y puede usar el panel en modo interactivo: puede navegar dentro del menú y submenú del panel y ejecutar el comando que necesita + +### Argumentos de comando + +Puede utilizar los comandos del panel como argumentos del script ./acore.sh. Por ejemplo: + +`./acore.sh compiler configure` ejecutará el proceso de configuración de nuestro compilador c++ + +Todos los comandos vienen con un alias más corto. Por ejemplo, `./acore.sh c configure` ejecutará la configuración del compilador, pero también `./acore.sh 5 3` lo hará. + +## Dependencias + +Nuestro sistema bash utiliza bibliotecas bash externas que son genéricas y no están relacionadas con el propio azerothcore, esas bibliotecas han sido creadas por nosotros y se han colocado en la carpeta / deps + +## GANCHOS: + +Interno [Sistema de gancho para bash](hooks-bash.md) + +## Otros recursos + +- Comando bash único para instalar azerothcore: [Video + secuencia de comandos en la descripción](https://www.youtube.com/watch?v=j1HI6pLZZvM) diff --git a/docs/es/best-practices.md b/docs/es/best-practices.md new file mode 100644 index 0000000..508553f --- /dev/null +++ b/docs/es/best-practices.md @@ -0,0 +1,35 @@ +# Mejores prácticas + +Una colección de las mejores prácticas para usar AzerothCore. + + +## Cambios personalizados + +- **NUNCA** agregue cambios personalizados a las fuentes de AzerothCore. [Crear módulos](http://www.azerothcore.org/wiki/Create-a-Module) en su lugar. + +Si necesita nuevos enlaces para implementar sus cambios personalizados en los módulos, no dude en enviar un PR que los implemente. + +Razones: + +1. Mantener limpio el código fuente base le facilitará la actualización. +2. Mantener sus personalizaciones en módulos le permitirá habilitarlas o deshabilitarlas fácilmente para solucionar cualquier problema potencial. +3. El software modularizado es mucho más fácil de mantener. + + +## Solicitudes de extracción (PR) + +- [Sincroniza tu fork](http://www.azerothcore.org/wiki/Syncing-your-fork) antes de abrir un PR. + +Razones: + +1. Ayuda a prevenir conflictos de fusión +2. Implementará (y probará) los cambios tal como se aplicaron a la última versión maestra. + +- **NUNCA** empuje los cambios a la rama `master`. Siempre tu rama "master" limpia. + +Cuando creas un nuevo PR, haz `git checkout master` y crea una nueva rama usando` git checkout -b new-branch`. + +Razones: + +1. Esto le permitirá crear múltiples RP que sean independientes entre sí. +2. Esto le permitirá actualizar fácilmente sus branches con el último master sincronizando primero su fork y luego fusionando `master` en branches.
\ No newline at end of file diff --git a/docs/es/bit-and-bytes-tutorial.md b/docs/es/bit-and-bytes-tutorial.md new file mode 100644 index 0000000..2a6bef7 --- /dev/null +++ b/docs/es/bit-and-bytes-tutorial.md @@ -0,0 +1,286 @@ +--- +redirect_from: "/Bit-and_bytes-tutorial" +--- + +# Tutorial de Bits y Bytes + +## Introducción + +En informática, los números se representan internamente en binario. Esto significa que, cuando usa un tipo entero para una variable, esto se representará internamente como una suma o concatenación de ceros y unos. + + + +También puede verlo asÃ: + + + +¡Esto también es cierto para los booleanos! Si tuviera un bit que fuera igual a 1 o un booleano que fuera igual a verdadero, no habrÃa diferencia en el valor de ambas variables. + +Si bien esto es cierto para la salida del valor, un booleano ocupa un byte completo. +Eso es porque no puede simplemente pedir prestado solo 1 bit, por lo que para definir un bool, necesita 1 byte u 8 bits. + +Como sabrá, un solo bit representa un 0 o un 1. Una concatenación de ocho de esos bits representa un Byte. El valor máximo de un byte es 255, que es la suma de todos los bits. Cada bit tiene un "valor" y la suma de todos los bits es lo que llamamos máscara. Por ejemplo, el valor del primer bit es 1, el valor del segundo bit es 2 * el valor del bit a su derecha. + + + + +``` c++ +// Esto es lo mismo que decir que 2^N=x, por ejemplo +2^0=1 +2^1=2 +2^2=4 +2^3=8 +2^4=16 +2^5=32 +2^6=64 +2^7=128 + +/* + * Puede representar un byte como una secuencia de ceros y unos en consecuencia. + * Leyendo asÃ, se lee el orden de los bits + * de derecha a izquierda + * <----- +*/ +1 = 0 0 0 0 0 0 0 1 +2 = 0 0 0 0 0 0 1 0 +4 = 0 0 0 0 0 1 0 0 +8 = 0 0 0 0 1 0 0 0 +16 = 0 0 0 1 0 0 0 0 +32 = 0 0 1 0 0 0 0 0 +64 = 0 1 0 0 0 0 0 0 +128 = 1 0 0 0 0 0 0 0 +``` + +Cuando un número tiene 4 bytes de longitud, esto significa que su número realmente usa 32 bits del almacenamiento interno: + +00000000 00000000 00000000 00000000 + +El tipo de datos entero de 32 bits puede contener valores enteros en el rango de −2,147,483,648 a 2,147,483,647. También puede referirse a este tipo de datos como firmado int o unsigned. Unsigned int significa que el tipo de datos de 32 bits unsigned int puede contener valores enteros en el rango de 0 a 4.294.967.295. +La razón por la que el int sin signo siempre almacenará más valores positivos que uno con signo es porque usamos los valores negativos del int con signo como positivos y esto duplica la cantidad de valores positivos que puede almacenar en una variable. + + +## ¿Para qué sirve? + +Ahora imagina que quieres crear un programa que contenga un estado, que se basa en varios valores: + +``` c++ +// Almacena el estado actual de este programa +bool firstValue = true; +bool secondValue = false; + +``` + +O en su lugar, use una única variable entera y use cada bit de sus 8 bits internos para representar los diferentes verdaderos y falsos. + +``` c++ +// 00000101 +int maskValue = 5; +``` + +Arriba, el primer bit es verdadero, que representa la primera variable. La segunda es falsa, que representa la segunda variable. La tercera verdad. Y asÃ... + +Esta es una forma muy compacta de almacenar datos y tiene muchos usos. + +Aquà es donde entra en juego el enmascaramiento de bits. Suena complejo, pero en realidad es muy simple. + +El enmascaramiento de bits permite al usuario: +1. Editar bits particulares en un byte(s) +2. Verificar si hay valores de bit particulares presentes o no. +3. Aplicar una máscara a un valor, donde en nuestro caso el valor es nuestro estado 00000101 y la máscara es nuevamente un número binario, que indica los bits de interés. En este caso nuestra máscara es la número 5. + +## Operaciones binarias + +### Bitwise AND "&" +Operar con bits es bastante similar a configurar condiciones entre dos variables. Digamos que tenemos, por ejemplo: + +``` C++ +if (1 && !0) + printf('Esta condición es verdadera'); +``` + +Cualquier valor que no sea 0 siempre será el mismo que verdadero. Esto significa que: + +- 1 es cierto +- !0 es lo mismo que decir no falso, lo que significa que !0 es verdadero +- verdadero y verdadero confirma la condición + +De esta manera podemos comparar los valores de 2 bits y si ambos son verdaderos, podemos mantener el valor del bit y obtener un resultado final de la misma manera: + +``` C++ +255 &= 1 + +// Esto dará como resultado que 255 se convierta en 1 debido a +// F - Falso y T - Verdadero para comparar los bits de 255 y 1 +(255) -> 1 1 1 1 1 1 1 1 +(1) -> 0 0 0 0 0 0 0 1 +(1) -> F F F F F F F T + 0 0 0 0 0 0 0 1 + +// Otro ejemplo: +Valor: 00000101 +Máscara: 00000100 +---- Y --------- +Resultado: 00000100 + +// En este caso tenemos el valor 5 +int MyState = 5; + +// Y queremos eliminar 1 estado de ese valor +MyState &= 4; + +/* Esto convertirá nuestro 00000101 (5) + * en un 00000100 (4) + */ +``` + +Los ejemplos anteriores son de hecho malos ejemplos de cómo usar cálculos de bits y pueden haberlo dejado con la duda. ¿Por qué no restar simplemente los valores de los números? + +5-1 = 4 + +es más fácil de entender que comparar bytes o bits y es más natural para el lenguaje humano. + +El punto en el uso de & en operaciones de bits suele ir acompañado de otro carácter de operación de bits que es el '~'. + +Lo que ~ te permite hacer es invertir la máscara de bits, por ejemplo: + +``` C++ +255 &= ~1; // Esto hará que 255 se convierta en 254 porque: +(255) -> 1 1 1 1 1 1 1 1 +(1) -> 0 0 0 0 0 0 0 1 // El primer bit es verdadero +(~1) -> 1 1 1 1 1 1 1 0 // invierte los bits en 1 -> 254 +(254) -> 1 1 1 1 1 1 1 0 +``` + +imagina una máscara de bits como esta: +1 0 0 0 0 0 0 0 (128) + +si se trataba de una operación entera, entonces 128 - 64 = 64 + +Sin embargo, si intentó eliminar 64 de 128: + +``` +1 0 0 0 0 0 0 0 &= ~64 + +(128) 1 0 0 0 0 0 0 0 +(64) 0 1 0 0 0 0 0 0 +(~64) 1 0 1 1 1 1 1 1 +--------------------- +( |
